法人番号APIの使い方

基礎知識•4分で読める•編集部

国税庁は法人番号システムWeb-APIを提供しており、プログラムから法人情報を取得できます。開発者向けにAPIの概要を解説します。

法人番号Web-APIとは

法人番号システムWeb-APIは、国税庁が提供する無料のAPIサービスです。法人番号や法人名から法人情報を検索・取得できます。

提供される機能

法人番号指定検索：法人番号を指定して情報取得（最大10件）
法人名指定検索：法人名を指定して検索
取得期間指定検索：指定期間内の変更情報を取得

※所在地（都道府県・市区町村）や法人種別は、上記検索の絞り込み条件として指定できます。

API利用の準備

1. アプリケーションIDの取得

APIを利用するには、事前にアプリケーションIDの取得が必要です。

法人番号公表サイトにアクセス
「Web-API」のページへ
利用規約に同意
メールアドレスを登録
アプリケーションIDを受け取る

2. 利用規約の確認

APIの利用には規約への同意が必要です。主な制限事項：

利用が著しく集中した場合、サービスが制限される可能性あり
取得したデータの利用目的制限
再配布に関する制限

APIエンドポイント

法人番号指定取得

GET /4/num?id={アプリケーションID}&number={法人番号}&type=12

法人名検索

GET /4/name?id={アプリケーションID}&name={法人名}&type=12

レスポンス形式

XML形式（type=01）
CSV形式（type=02）
JSON形式（type=12）

レスポンス例（JSON）

{
  "corporation": [
    {
      "sequenceNumber": "1",
      "corporateNumber": "1234567890123",
      "process": "01",
      "correct": "0",
      "updateDate": "2024-01-15",
      "changeDate": "2024-01-10",
      "name": "株式会社サンプル",
      "nameImageId": "",
      "kind": "301",
      "prefectureName": "東京都",
      "cityName": "千代田区",
      "streetNumber": "丸の内1-1-1",
      "postCode": "1000001"
    }
  ]
}

主なフィールド

フィールド	説明
corporateNumber	法人番号（13桁）
name	商号または名称
kind	法人種別コード
prefectureName	都道府県
cityName	市区町村
streetNumber	丁目番地等
updateDate	更新日
changeDate	変更日