既知の問題 (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
ステータス: 未修正
重大度: 低
法人名の漢字のうち、ごく一部の漢字は ＿ で表されていて、正しく漢字を表示できていないものがあります。
国税庁が公開する法人番号データそのものがこのように表現しているため、この漢字を正しく表示する手段はありません。
茨城県つくば市の区画整理地の住所についてこの見出しへのリンク
報告日: 2021/10/18
ステータス: 未修正
重大度: 低
茨城県つくば市におけるつくばエクスプレス沿線開発による区画整理地では、予定町名と仮換地街区画地番号を括弧書きで併記するよう、つくば市から通達されています (参考: つくば市の通達)。
法人番号APIのレスポンスのうち、town・block_lot・building・floor_room は street_number の住所が一意に定まることを想定しているため、括弧書きで表示された予定町名 + 仮換地街区画地番号は出力していません。
以下、レスポンスの一部の一例です (住所は架空のものです)。
{
"street_number": "みどりの２０６番地２７ (万博公園中央Ｚ５９街区８) ノーブルハイツ５０７号",
"town": "みどりの",
"block_lot": "２０６番地２７",
"building": "ノーブルハイツ",
"floor_room": "５０７号"
}区画整理後の住所が必要な場合は、street_number から抽出してご利用ください。
address フィールドの構造変更 (バージョン間の破壊的変更)この見出しへのリンク
法人番号APIの address フィールドは、バージョンによって構造が異なります。2022-09-01 系ではフラットな構造でしたが、2024-01-01 以降ではネストされた object に統一されました。旧バージョンで運用中のシステムを新バージョンへ移行する場合は、レスポンスの参照箇所を修正する必要があります。詳細は法人番号APIリファレンスのバージョンごとの記載を参照してください。
銀行情報APIこの見出しへのリンク
branches / branch の構造変更 (バージョン間の破壊的変更)この見出しへのリンク
銀行情報APIの branches / branch 配下の値は、2024 系では単一のオブジェクトでしたが、2025 系ではオブジェクトの配列に変更されました。旧バージョンで運用中のシステムを新バージョンへ移行する場合は、レスポンス処理ロジックの修正が必要です。詳細は銀行情報APIリファレンスのバージョンごとの記載を参照してください。
問題を報告するこの見出しへのリンク
本ページに記載のない問題を発見された場合、以下からご報告ください。
報告時は以下の情報を含めていただくと対応が早くなります。
- 該当 API エンドポイント・APIバージョン
- リクエスト内容 (curl 形式等、APIキーは伏字で)
- 実際のレスポンス
- 期待していた挙動
最終更新: 2026-07-14