公式一次ソース準拠 / OpenAPI 3.1

国税庁 法人番号Web-API Ver.4 OpenAPIドキュメント

法人番号を使った企業データ連携の実装向けに、法人番号指定・期間差分取得・商号／名称検索を 1ページで確認できるAPI仕様書です。CSV/XMLレスポンス、必須パラメータ、エラーコードをまとめています。

Swagger UIで確認する OpenAPI YAMLを取得する エラーコード一覧を見る

このドキュメントでわかること

対象エンドポイント

/4/num・/4/diff・/4/name の3機能を網羅しています。

データ形式

type=01/02（CSV）と type=12（XML）を公式仕様どおりに記載しています。

導入時の注意点

アプリケーションID必須、期間上限、分割取得、404の挙動差異など実装で詰まりやすい点を明示しています。

一次情報へのリンク

国税庁のWeb-APIページ・PDF仕様書・利用規約・リソース定義に直接アクセスできます。

Ver.4 エンドポイント一覧

パス 用途 代表検索語
/4/num 法人番号を指定して法人情報を取得（最大10件） 法人番号 指定 API
/4/diff 更新期間を指定して差分情報を取得（最大50日） 法人番号 差分 取得 API
/4/name 商号又は名称で法人情報を検索 商号 名称 検索 API

公式一次ソース

APIリファレンス（Swagger UI）

下記でパラメータ・レスポンスを確認できます。Try it out で実行する場合は、有効なアプリケーションIDを指定してください。