既知の問題 (Known Issues)
要約: ケンオールAPI で確認されている既知の問題と、API リファレンスに記載のある破壊的変更をまとめます。実装前に一読ください。
📋 目次この見出しへのリンク
郵便番号→住所APIこの見出しへのリンク
town_kana の内容が town と一致していないこの見出しへのリンク
報告日: 2021/02/08
ステータス: 未修正
重大度: —
町名以下のカナ表記である town_kana のデータは、現在 town と完全に一致しているわけではありません。これは、カナだけの文字のパースが、漢字を含む町名のパースよりも困難であることに起因します。
大口事業所個別番号の town と block_lot の分割が正しくないものがあるこの見出しへのリンク
報告日: 2021/02/08
ステータス: 未修正
重大度: —
大口事業所個別番号の町名以下はフリーテキストで記載されているため、データの解析処理が困難となっています。そのため、現在の town と block_lot は正しく分割できていないレコードが存在します。
法人番号APIこの見出しへのリンク
一部未対応の漢字があるこの見出しへのリンク
報告日: 2021/09/21
ステータス: 未修正
重大度: 低
法人名の漢字のうち、ごく一部の漢字は ＿ で表されていて、正しく漢字を表示できていないものがあります。
国税庁が公開する法人番号データそのものがこのように表現しているため、この漢字を正しく表示する手段はありません。
住所分割フィールド (town / block_lot_num / building / floor_room) に値が入らないことがあるこの見出しへのリンク
報告日: 2021/09/21
ステータス: 仕様 (未修正)
重大度: 低
法人番号API・法人情報検索API・バッチ法人情報検索API・適格請求書発行事業者APIのレスポンスに含まれる town・kyoto_street・block_lot_num・building・floor_room は、国税庁が公開する street_number (町域以下の住所を表す1本のフリーテキスト) をケンオールが解析して切り出した参考値です。
元データの表記ゆれ・誤字脱字・想定外の書式・外字などにより解析できなかった場合、該当する要素が住所に含まれていても null または空文字になります。また、値が格納されていても分割位置を誤っていることがあります。これらのフィールドに値が格納されることも、分割結果が正確であることも仕様として保証していません。
住所として必ず値が必要な場合や正確性が要求される場合は、原本である street_number (および prefecture / city / postal_code) をご利用ください。詳細は法人番号APIリファレンスの「住所分割フィールドの制限事項」を参照してください。
address フィールドの構造変更 (バージョン間の破壊的変更)この見出しへのリンク
法人番号APIの address フィールドは、バージョンによって構造が異なります。2022-09-01 系ではフラットな構造でしたが、2024-01-01 以降ではネストされた object に統一されました。旧バージョンで運用中のシステムを新バージョンへ移行する場合は、レスポンスの参照箇所を修正する必要があります。詳細は法人番号APIリファレンスのバージョンごとの記載を参照してください。
茨城県つくば市の区画整理地の住所についてこの見出しへのリンク
報告日: 2021/10/18
ステータス: 未修正
重大度: 低
茨城県つくば市におけるつくばエクスプレス沿線開発による区画整理地では、予定町名と仮換地街区画地番号を括弧書きで併記するよう、つくば市から通達されています (参考: つくば市の通達)。
法人番号APIのレスポンスのうち、town・block_lot_num・building・floor_room は street_number の住所が一意に定まることを想定しているため、括弧書きで表示された予定町名 + 仮換地街区画地番号は出力していません。
以下、レスポンスの一部の一例です (住所は架空のものです)。
{
"street_number": "みどりの２０６番地２７ (万博公園中央Ｚ５９街区８) ノーブルハイツ５０７号",
"town": "みどりの",
"block_lot_num": "206-27",
"building": "ノーブルハイツ",
"floor_room": "507号"
}区画整理後の住所が必要な場合は、street_number から抽出してご利用ください。
銀行情報APIこの見出しへのリンク
branches / branch の構造変更 (バージョン間の破壊的変更)この見出しへのリンク
銀行情報APIの branches / branch 配下の値は、2024 系では単一のオブジェクトでしたが、2025 系ではオブジェクトの配列に変更されました。旧バージョンで運用中のシステムを新バージョンへ移行する場合は、レスポンス処理ロジックの修正が必要です。詳細は銀行情報APIリファレンスのバージョンごとの記載を参照してください。
問題を報告するこの見出しへのリンク
本ページに記載のない問題を発見された場合、以下からご報告ください。
報告時は以下の情報を含めていただくと対応が早くなります。
- 該当 API エンドポイント・APIバージョン
- リクエスト内容 (curl 形式等、APIキーは伏字で)
- 実際のレスポンス
- 期待していた挙動
最終更新: 2026-09-18