法人番号システム Web-API

Web-API機能は、利用者の皆様が保有するシステムからインターネットを経由して、簡単なリクエストを送信していただくことで、指定した法人番号の法人に係る情報や、指定した期間及び地域で抽出した法人の更新(差分)情報を取得するための、システム間連携インターフェース(データ授受の方式)を提供するものです。

法人番号システムWeb-APIの概要

  • Web-APIのアーキテクチャスタイルは、REST方式です。
  • 企業等のシステムから法人番号公表機能に条件を指定してリクエストを送信すると、指定された条件に基づき、法人番号システムに動的にデータを生成しデータを応答します。

提供する機能及び取得可能なデータ

  • 法人番号指定ダウンロード機能

    法人番号を指定しリクエストすることで、指定した法人番号の基本3情報及び付随する情報を提供することができます。条件指定することにより指定した法人の変更履歴を併せて取得することもできます。

  • 差分情報ダウンロード機能

    取得期間を指定しリクエストすることで、指定した期間における法人番号指定、商号・所在地の変更及び登記記録の閉鎖等の事由に係る情報を取得することができます。所在地(都道府県・市区町村)及び法人種別を条件に追加し、取得する情報を絞り込むこともできます。
     (注)Web-API機能では全件データを取得することはできません。

ページの先頭へ戻る

Web-APIの利用に当たって

利用規約

Web-API機能は、どなたでもご利用いただけます。「Web-APIの利用規約」に同意いただいた上で、ご利用ください。

Web-APIの利用規約

アプリケーションID

  • Web-APIを利用するためには、アプリケーションIDが必要です。(アプリケーションIDの発行に費用は掛かりません。)アプリケーションIDをお持ちでない方は、利用規約を確認していただき、アプリケーションIDの発行手続を行ってください。
  • アプリケーションID発行手続の方法は、当サイトで届出情報を入力・送信する方法と、届出書を持参又は郵送して提出する方法がございます。

    当サイトで発行手続を行う場合はこちら

    アプリケーションIDの発行届出フォーム

    届出書を提出して発行手続を行う場合はこちら

    アプリケーションIDの発行届出

全件データの取得について

全件データの取得方法は、以下のとおりです。

情報の取得元の明示

Web-API機能を使用したサービスを公開される場合には、下記の情報の取得元の明示をお願いします。

「このサービスは、国税庁法人番号システムのWeb-API機能を利用して取得した情報をもとに作成」

利用される方が参照できる場所であれば、表示場所の指定はございません。

ページの先頭へ戻る

Web-APIの詳細について

Web-APIの利用手続、リクエストの設定方法及び提供データの内容等については、「Web‐API の利用手続、リクエストの設定方法及び提供データの内容について」を参照してください。また、提供するデータ項目及びデータ形式等については、「基本3情報ダウンロード-ダウンロードファイルのデータ定義」の「リソース定義書」を参照してください。

基本3情報ダウンロード/リソース定義書

Web‐API の利用手続、リクエストの
設定方法及び提供データの内容について

ダウンロード(PDF/1.42MB)

PDF形式のファイルをご覧いただく場合には、Adobe Readerが必要です。Adobe Readerをお持ちでない方は、次のバナーのリンク先からダウンロードしてください。 Get Adobe Reader(新規ウィンドウが開きます)

ページの先頭へ戻る

Web-APIの事前検証

国税庁では、利用者が構築するシステムとのインターフェース検証テストのために、架空の法人又は団体名称等を使用したWeb-API事前検証環境を提供しております。

事前検証環境の利用に当たっては、アプリケーションIDが必要となります。事前検証環境を利用するには、国税庁へ連絡いただく必要がありますが、連絡方法等については、アプリケーションIDをお知らせする際に、ご案内しますので、そちらをご覧ください。

ページの先頭へ戻る

お問い合わせ

Web-API仕様に関するお問い合わせを受け付けております。 「Web-APIに関するお問い合わせ」のフォームに必要事項を入力の上、送信ください。メールにて回答いたします。

Web-APIに関するお問い合わせ