法人番号システムWeb-APIの使い方：アプリケーションID申請から名称検索・差分取得まで

国税庁の法人番号システムWeb-APIは、アプリケーションIDを付けたGETリクエスト1本で、法人番号・法人名・更新期間のいずれかを条件に、基本3情報（商号又は名称、本店又は主たる事務所の所在地、法人番号）と付随情報をCSVまたはXMLで返すAPIです。 最新版はVer.4.0で、Ver.1.0〜3.0も並行して稼働しています。

この記事では、アプリケーションIDの発行届出、3種類のリクエストとパラメータ、レスポンスの読み方、変更履歴の扱いを公式仕様から整理し、最後にAIエージェントで取引先マスタを照合するときの手順と注意をまとめます。

先に押さえること

アプリケーションIDを申請する

共通編の仕様書（5章）が示す手順はこうです。

1. 国税庁適格請求書発行事業者公表サイト内の「アプリケーションID発行届出仮登録」画面（https://www.invoice-kohyo.nta.go.jp/web-api/pre-reg/）にメールアドレスを入力して送信する
2. 届いたメールに「アプリケーションID発行届出フォーム」のURLがあるので、届出情報を入力して送信する
3. 届出後、アプリケーションIDがメールで通知される

書面など受付画面以外での申請は受け付けておらず、添付書類・手数料は不要です。IDは原則としてWeb-APIサーバと通信するシステムごとに発行され、同一のメールアドレスで複数のIDを届け出ることはできません。公表サイトのWeb-APIページは、発行に2週間から1か月程度かかると案内しています。

法人番号システムWeb-APIだけを使う場合は追加の連絡が要ります。 届出フォームは適格請求書発行事業者公表システムのWeb-APIと共通のため、届出とは別に、フォームで入力した氏名又は名称、メールアドレス、法人番号システムWeb-APIのみ利用希望である旨の3点を、国税庁軽減税率・インボイス制度対応室宛にメール（[email protected]）で連絡します。

架空の法人名を使った検証環境もあります。IDは本番・検証環境どちらでも使え、利用したい場合はWeb-APIお問い合わせフォームからID、法人名又は氏名、メールアドレス、電話番号、利用予定期間（3か月以内）を連絡すると、概ね1週間以内に案内が届きます。

利用規約で運用に効く条項は次のとおりです。

• 第4条：利用者は通知を受けたIDの管理責任を負う。不正利用・亡失・利用停止は速やかに連絡する。3年間アクセスがないと利用停止されることがある
• 第6条：Web-APIを利用したサービスを提供する場合、「このサービスは、国税庁法人番号システムWeb-API機能を利用して取得した情報をもとに作成しているが、サービスの内容は国税庁によって保証されたものではない」を適宜の場所に明示する
• 第8条：利用が著しく集中した場合等には利用を制限できる
• 第9条：短時間における大量アクセス、IDの第三者への譲渡・貸与・開示の禁止
• 第10条：国税庁の故意又は重過失による場合を除き免責

IDはコードやプロンプトに書かず、環境変数で渡します。

export HOUJIN_APP_ID="メールで通知された13桁のアプリケーションID"

3種類のリクエスト

Web-APIはREST方式で、メソッドはGETです。バージョンはURLのパスに 1〜4 の数字で指定します。

法人番号を指定して取得する（num）

https://api.houjin-bangou.nta.go.jp/4/num?id=<アプリケーションID>&number=<法人番号>[,<法人番号>…]&type=12&history=0

history=1 にすると、商号変更などの履歴が古い順に複数行で返り、latest が 1 の行が最新情報です。

curl -s "https://api.houjin-bangou.nta.go.jp/4/num?id=${HOUJIN_APP_ID}&number=7000012050002&type=12&history=1"

（7000012050002 は公表サイトのフッターに記載されている国税庁自身の法人番号です。）

期間を指定して差分を取得する（diff）

https://api.houjin-bangou.nta.go.jp/4/diff?id=<アプリケーションID>&from=YYYY-MM-DD&to=YYYY-MM-DD&type=12[&address=..&kind=..&divide=..]

期間指定で取れるのはWeb-API公開日（2015年12月1日）以後の差分だけです。全件（前月末時点の最新情報）が必要なら公表サイトのダウンロード機能を使う、と共通編は明記しています。

法人名を指定して取得する（name）

Ver.2.0以降で使えます。

https://api.houjin-bangou.nta.go.jp/4/name?id=<アプリケーションID>&name=<URLエンコードした法人名>&type=12[&mode=..&target=..&address=..&kind=..&change=..&close=..&from=..&to=..&divide=..]

前方一致は「株式会社」などの法人種別を除いた名称の先頭から照合し、部分一致は法人種別を含めて照合します。あいまい検索（target=1）はひらがなをカタカナに、英小文字を英大文字に置き換え、中点や全角スペースを削除した上で照合するので、表記ゆれに強い代わりに候補が広がります。

curl -s -G "https://api.houjin-bangou.nta.go.jp/4/name" \
  --data-urlencode "id=${HOUJIN_APP_ID}" \
  --data-urlencode "name=国税商事" \
  --data-urlencode "type=12" \
  --data-urlencode "mode=2"

有効なIDがない状態で num を叩くと、2026年9月14日の実行ではHTTP 404で Not Found のHTMLが返りました（空のIDでも dummy でも同じ）。仕様書にあるCSV形式のエラーコード応答はこの条件では返らなかったので、IDの有無はHTTPステータスで先に検知できます。

レスポンスの読み方

CSVでもXMLでも、先頭にヘッダー情報4項目が付き、その後に法人ごとのデータが続きます。

CSVには項目名が入りません。 2行目以降のカンマ区切りの並びは、別紙のリソース定義書で「提供項目_Web-API（ver1〜4）」に○が付いた項目の順です。位置で意味が決まるので、CSVを扱うならXMLのタグ名（＝リソース名）と対応させたマッピングを持っておくのが安全です。

仕様書に載っている、架空の法人番号 8040001999013 をXMLで引いたときのサンプルはこの形です（項目を抜粋）。

<corporations>
 <lastUpdateDate>2017-05-10</lastUpdateDate>
 <count>1</count>
 <divideNumber>1</divideNumber>
 <divideSize>1</divideSize>
 <corporation>
  <sequenceNumber>1</sequenceNumber>
  <corporateNumber>8040001999013</corporateNumber>
  <process>11</process>
  <correct>0</correct>
  <updateDate>2017-05-09</updateDate>
  <changeDate>2017-05-09</changeDate>
  <name>株式会社商号変更後</name>
  <kind>301</kind>
  <prefectureName>千葉県</prefectureName>
  <cityName>千葉市中央区</cityName>
  <streetNumber>蘇我５丁目９番１号</streetNumber>
  <prefectureCode>12</prefectureCode>
  <cityCode>101</cityCode>
  <postCode>2600822</postCode>
  <assignmentDate>2015-10-05</assignmentDate>
  <latest>1</latest>
  <furigana/>
  <hihyoji>0</hihyoji>
 </corporation>
</corporations>

照合で効く項目は次のとおりです。

• process（処理区分）：01 新規、11 商号又は名称の変更、12 国内所在地の変更、13 国外所在地の変更、21 登記記録の閉鎖等 など
• latest（最新履歴）：1 が最新、0 が過去の情報
• closeDate / closeCause / successorCorporateNumber：登記記録の閉鎖等の年月日・事由・承継先法人番号
• changeCause（変更事由の詳細）、assignmentDate（法人番号指定年月日）
• enName 等はVer.2.0以降、furigana はVer.3.0以降、hihyoji（検索対象除外）はVer.4.0以降

並び順も決まっています。numは法人番号昇順→履歴の古い順、diffは更新年月日→法人番号、nameは名称のUTF-8コード順→法人番号で、sequenceNumber はその順に振られます。

更新タイミングは、公表用データベースが当日11時と16時の2回更新され、num・nameは登記完了日の16時又は翌稼働日の11時に反映、diffは登記完了日の翌日午前0時に反映です。休祝日と12月29日〜1月3日は更新されません。当日分をすべて差分で取りたい場合は、日付切替後に前日の日付で diff を呼びます。

diffとnameは応答が2,000件を超えると分割されます。ヘッダーの divideSize が 1 でなければ、divide を divideNumber が divideSize に一致するまでカウントアップして再リクエストします。

AIエージェントで取引先マスタを照合する

取引先マスタの「社名」を法人番号に紐づける作業は、エージェントに任せやすい半面、同名法人と表記ゆれで事故が起きやすい領域です。次の手順に固定します。

1. マスタの社名で name を引く。 mode=2（部分一致）、target=1（あいまい検索）で候補を広めに取り、法人番号・所在地・kind・closeDate を並べる。
2. 候補が複数なら所在地で絞る。 マスタに都道府県があれば address に都道府県コードを渡す。それでも複数残るなら、エージェントは候補を提示して止まり、人が法人番号を選ぶ。
3. 確定した法人番号で num を history=1 で取り直す。 latest=1 の行をマスタの正とし、旧商号は別名として保持する。
4. 以後は diff を日次で回す。 前日の日付で取得し、マスタにある法人番号の process が 11（商号変更）、12（所在地変更）、21（閉鎖等）なら差分として提示する。successorCorporateNumber があれば承継先を添える。
5. 閉鎖法人は削除せずフラグを立てる。 closeDate が入った法人はマスタから消さず「閉鎖」として残す。

エージェントへの指示は、CLAUDE.mdやAGENTS.mdに次の程度で置きます。

## 法人番号 Web-API を使うときのルール
- 社名で検索したら候補（法人番号・所在地・closeDate）を表にして止まる。私が法人番号を選ぶまで確定しない
- 確定後は法人番号で num を history=1 で取り直し、latest=1 の行を採用する
- change=1 で旧商号がヒットしても、その行を最新として扱わない（num で取り直す）
- 結果には corporateNumber・lastUpdateDate・取得日時を必ず付ける
- アプリケーションIDは環境変数 HOUJIN_APP_ID から読む。URL・ログ・出力に含めない
- 公開するサービスには規約第6条の出典明示文言を入れる

API側に用意されている「あいまい検索」と「変更履歴」は、人が最終確定する前提でこそ役に立ちます。エージェントに全部を任せて確定まで進めると、あいまい検索の広さがそのまま誤マッチの広さになります。

まとめ

• アプリケーションIDは適格請求書発行事業者公表サイトの届出フォームから無料で申請。13桁、2週間〜1か月、システムごとに1つ。法人番号のみ利用ならメールでその旨を連絡
• リクエストは num（法人番号最大10件）、diff（最大50日、2015-12-01以降）、name（Ver.2.0以降）の3種類。type=01/02/12 で形式を選ぶ
• レスポンスは4項目のヘッダー＋法人データ。CSVには項目名がないのでリソース定義書で位置を確認。latest、process、closeDate、successorCorporateNumber が照合の鍵
• 2,000件超は divide で分割取得。更新は11時・16時、diffは翌日0時
• 取引先マスタの照合は「名称→候補→人が法人番号を確定→番号で再取得→差分で追従」に固定する

法人番号で確定した後、行政保有情報（認定・調達・補助金など）へ広げるならGビズインフォ、法定開示書類へ広げるならEDINETが法人番号を持っています。その組み合わせと、認証キーを持つAPIをMCPにするときの共通設計は公共データAPIをMCP化する設計パターンで扱います。IDのような秘密をエージェントから隔離する一般論はAIエージェントの秘密情報保護を参照してください。