第五編
Web-API（Ver.3.0）のリクエストの設定方法及び提供データの内容について－公表サイト－－ 1.4 版 －令和４年４月
国税庁
法人番号管理室

改版履歴
項
番
１

版数

作成年月

変更内容

変更理由等

初版

平成 30 年１月

Web-API のデータ項目追加（商―号又は名称に対するフリガナ情報）に伴い、新規に作成。
２

1.1 版

平成 31 年 1 月①表題を「Web-API のリクエストの新たに「第二編 Web-

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

ついて（Ver.3.0）」から「第五編トの設定方法及び提供デ

Web-API（Ver.3.0）のリクエストのータの内容について（概設定方法及び提供データの内容に要編）」を作成したことかついて」に変更。

ら、本書を第四編から第②第一章を「1.法人番号システム

五編に移動する。

Web-API 機能について」から「1.

また、Web-API(Ver.3.

解説書の構成について」に変更。

0)への対応関係を明確に

解説書の構成を刷新。

するため表題を変更する。第一章において第一編・第二編との重複を削
除する。

３

1.2 版

令和３年２月法人設立ワンストップサービ―

スの導入に伴い、所要の整備を行
う。
４

1.3 版

令和３年 10 月

アプリケーション ID の発行手―

続方法の変更に伴い、アプリケー
ション ID の通知方法を変更する。
５

1.4 版

令和４年４月

情報記録媒体によるデータ提供に関する記載を削除。

全件データの情報記
録媒体によるデータ提供のサービス終了。

－ 目 次 －１.

解説書の構成について ........................................... 1２.

法人番号を指定して情報を取得する機能について.................... 2

2.1. 法人番号を指定して情報を取得する機能の概要 ............................. 2
2.2. リクエストのフォーマット ............................................... 2
2.2.1. バージョン ........................................................... 2
2.2.2. アプリケーション ID................................................... 3
2.2.3. 条件 ................................................................. 3
2.3. 法人番号を指定して情報を取得する機能のリクエスト例と応答結果のサンプル . 4
2.3.1. 変更履歴を含めない場合 ............................................... 4
2.3.2. 変更履歴を含める場合 ................................................. 92.4. 一連番号の設定（ソート順） ............................................ 12３.

取得期間を指定して情報を取得する機能について................... 13

3.1. 取得期間を指定して情報を取得する機能の概要 ............................ 13
3.2. リクエストのフォーマット .............................................. 13
3.2.1. バージョン .......................................................... 13
3.2.2. アプリケーション ID.................................................. 14
3.2.3. 条件 ................................................................ 14
3.3.

取得期間を指定して情報を取得する機能のリクエスト例とサンプルデータについて .......................................................................... 16
3.4. 一連番号の設定（ソート順） ............................................ 20
3.5. 応答結果の分割について ................................................ 20

４.

法人名を指定して情報を取得する機能について .................... 21

4.1. 法人名を指定して情報を取得する機能の概要 .............................. 21
4.2. リクエストのフォーマット .............................................. 21
4.2.1. バージョン .......................................................... 21
4.2.2. アプリケーション ID.................................................. 22
4.2.3. 条件 ................................................................ 22
4.3.

法人名を指定して情報を取得する機能のリクエスト例とサンプルデータについて............................................................................ 26
4.4. 一連番号の設定（ソート順） ............................................ 29
4.5. 応答結果の分割について ................................................ 30
4.6. 法人名検索方式について ................................................ 30
4.6.1. 商号又は名称検索方式 ................................................ 30
4.6.2. 商号又は名称検索対象 ................................................ 31

５. エラーコード及び HTTP ステータスコード .......................... 34（別紙）
別紙１ リソース定義書（ダウンロードファイル、Web-API）－公表サイト－
別紙２ HTTP ステータスコード、エラーコード及びエラーメッセージ一覧

１.

解説書の構成について

Web-API の解説書は、本書を含め、以下のとおり６編で構成しています。
本書では、Web-API（Ver.3.0）のリクエストフォーマット、リクエスト例及び応答結果のサンプル（データ）について説明しています。

第一編

Web-API の利用手続について（共通編）－公表サイト－

第二編 Web-API のリクエストの設定方法及び提供データの内容について（概要編）－公表サイト－
第三編

Web-API（Ver.1.0）のリクエストの設定方法及び提供データの内容について－公表サイト－

第四編

Web-API（Ver.2.0）のリクエストの設定方法及び提供データの内容について－公表サイト－

第五編

第六編

Web-API（Ver.3.0）のリクエストの設定方法及び提供データの内容について－公表サイト－ 本書

Web-API（Ver.4.0）のリクエストの設定方法及び提供データの内容について－公表サイト－

1

２.

法人番号を指定して情報を取得する機能について

2.1.

法人番号を指定して情報を取得する機能の概要

法人番号を指定して情報を取得する機能では、法人番号を指定（１件から最大 10 件）してリクエストを送信（「2.2 リクエストのフォーマット」に記
載のフォーマットに基づいて、Web-API に送信）することにより、条件に指定した法人の基本３情報を、指定したファイル形式及び文字コードで取得することができます。
また、任意の条件設定項目を指定することで、変更履歴情報も併せて取得することができます。
Web-API の Ver.3.0 では、Ver.2.0 の応答結果に加え、商号又は名称に対するフリガナ情報も取得することができます。
2.2. リクエストのフォーマット
法人番号を指定して情報を取得する機能のリクエストのフォーマットは以下のとおりです。四角で囲った「バージョン」、「アプリケーション ID」、
「法人番号」、「応答形式」及び「変更履歴要否」にセットする値について説明します。
https://api.houjin-bangou.nta.go.jp/ バージョン /num?id= アプリケーシ
ョン ID&number=法人番号（１件目）,法人番号（２件目）,…&type=応答形式&変更履歴要否2.2.1. バージョン
バージョンは、Web-API のバージョン値で、「３（半角）」をセットします。
バージョンアップの方針
提供するデータ項目や抽出条件に追加や変更があった場合などに、バージョンアップすることとなりますが、基本方針としては、下位のバージョンと、上位のバージョンを並行して稼働させることを前提としています。
2

バージョンアップ情報の事前連絡
バージョンアップの予定については、事前に十分な準備期間を確保した上で法人番号公表サイトを通じてお知らせするとともに、アプリケーショ
ン ID の発行届出時に記載又は入力いただいた電子メールアドレス宛に、バージョンアップに係る情報を配信することを予定しています。
2.2.2. アプリケーション ID
アプリケーション ID は、アプリケーション ID 発行届出後、国税庁がメー
ルによりお知らせするアプリケーション ID（13 桁）をセットします。
2.2.3. 条件
条件は、①法人番号、②応答形式、③変更履歴の要否という３つの項目について、下表の各項目 ID に対応する項目値を「項目 ID＝項目値」という形式でセットし、各条件を「＆」で繋ぐことで設定することができます。
なお、下表の各項目の欄に【必須】と記載されている条件は必ず設定してください。
項目【必須/任意】

法人番号
【必須】

項目 ID

number

項目値

法人番号

‐
応答形式
【必須】

type
01
02
12

変更履歴
要否
【任意】

history‐

項目値の説明13 桁の法人番号を指定します。カンマ区切り
で複数（最大 10 件）の法人番号を指定することができます。
「&number=1111111111111,2222222222222」とセットした場合、法人番号 1111111111111 及び2222222222222 に該当する法人のデータが応答されます。
リクエストに対して応答するデータのファイ
ル形式と文字コードを指定します。
「&type=01」とセットした場合、ファイル形式
は CSV、文字コードは Shift-JIS に縮退されたデータが応答されます。
CSV 形式/Shift-JIS(JIS 第一・第二水準)
CSV 形式/Unicode(JIS 第一水準から第四水準)
XML 形式/Unicode(JIS 第一水準から第四水準)
公表情報の変更履歴を取得するかどうかを指定します。
「&history=1」とセットすると、新規に法人番号を公表した時点のデータから、リクエスト時
点までの公表情報の変更履歴を、各１レコード
3

項目【必須/任意】

項目 ID

項目値

項目値の説明0
1の更新データとして応答します。
例えば、１つの対象法人等について、公表開始
以後に２度の商号変更があった場合には、３レ
コード分のデータが応答されます。
指定しない場合は、「０」（変更履歴なし）として処理されます。
変更履歴なし変更履歴あり「応答形式」で設定したファイル形式で、データが応答されます。応答されたデータについては、「別紙１ リソース定義書（ダウンロードファイル、
Web-API）－公表サイト－」（以下、「リソース定義書」といいます。）の「提供項目_Web-API（ver3）」欄に「○」が記載されている項目をご覧ください。
2.3. 法人番号を指定して情報を取得する機能のリクエスト例と応答結果のサンプル
法人番号を指定して情報を取得する機能のリクエスト例と、応答結果のサ
ンプルについて、変更履歴を含める場合と含めない場合に分けて、それぞれ説明します。
なお、リクエスト例のうち、アプリケーション ID については、説明の都合上、仮 ID（Ktest01test01）を設定しております。実際のリクエスト時にはご利用いただけませんのでご留意ください。
2.3.1. 変更履歴を含めない場合
リクエスト条件に、変更履歴は不要と設定した場合の応答結果のサンプルです。
ケース１（ファイル形式を CSV、文字コードを Shift-JIS と指定するケース）（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/num?id=Ktest01test01&number=7400001010001&type=01&history=0（リクエスト指定条件）
条件&number=7400001010001&type=01

条件の内容
法人番号「7400001010001」の１件のみ。
応答形式は「CSV 形式/Shift-JIS(JIS 第
一・第二水準)」とする。
4

&history=0
変更履歴は含めない。
（応答結果のサンプル）
ヘッダー情報2018-05-09,1,1,1
1,7400001010001,01,1,2018-05-08,2015-10-05,"株式会社フリガナ登録",,301,"岩手県","盛岡市","内丸 10 番１号",,03,201,0200023,,,,,,,2
１レコード
015-10-05,1,,,,,"フリガナトウロク"（応答結果の内容）
イ ヘッダー情報
ファイル形式を CSV と指定した場合、応答結果の１行目にヘッダー情報
として最終更新年月日、総件数、分割番号及び分割数の４項目が応答され
ます。
項目名
データ値
最終更新年月日2018-05-09
総件数
1
分割番号
1
分割数
1
ロ データ項目
CSV データの２行目から、リクエストに対応する法人等のデータが応答されます。データ項目名及びデータ値は下表のとおりです。
項目名
データ値
一連番号
1
法人番号
7400001010001
処理区分
01
訂正区分
1
更新年月日
2018-05-08
変更年月日
2015-10-05
商号又は名称
株式会社フリガナ登録
商号又は名称イメージ ID
法人種別301
国内所在地（都道府県）
岩手県
国内所在地（市区町村）
盛岡市
国内所在地（丁目番地等） 内丸１０番１号
国内所在地イメージ ID
都道府県コード
03
市区町村コード201
郵便番号0200023
国外所在地
国外所在地イメージ ID
5

項目名
データ値
登記記録の閉鎖等年月日
登記記録の閉鎖等の事由
承継先法人番号
変更事由の詳細
法人番号指定年月日
2015-10-05
1
最新履歴
商号又は名称（英語表記）
国内所在地（都道府県）（英語表記）
国内所在地（市区町村丁目番地
等）（英語表記）

国外所在地（英語表記）
フリガナ
フリガナトウロク※ Ver.3.0 では、Ver.2.0 にデータ項目「フリガナ」のデータが追加されています。
ケース２（ファイル形式を CSV、文字コードを Unicode と指定するケース）（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/num?id=Ktest01test01&number=7400001010001&type=02&history=0（リクエスト指定条件）
条件
条件の内容&number=7400001010001
法人番号「7400001010001」の１件のみ。
応答形式は「CSV 形式/Unicode(JIS 第一水&type=02
準から第四水準)」とする。
&history=0
変更履歴は含めない。
（応答結果のサンプル）
応答結果については、ケース１と同じ値が、指定した文字コード（Unicode）で応答されます。
（応答結果の内容）
応答結果の内容については、ケース１と同様です。
ケース３（ファイル形式を XML と指定するケース）（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/num?id=Ktest01test01&number=7400001010001&type=12&history=0（リクエスト指定条件）

6

条件&number=7400001010001&type=12&history=0

条件の内容
法人番号「7400001010001」の１件のみ。
応答形式は「XML 形式/Unicode(JIS 第一水準から第四水準)」とする。
変更履歴は含めない。

7

（応答結果のサンプル）[XML Editor で開いた場合の表示]<?xml version="1.0" encoding="UTF-8"?><corporations>
ヘッダー情報<lastUpdateDate>2018-05-09</lastUpdateDate><count>1</count><divideNumber>1</divideNumber><divideSize>1</divideSize><corporation>
１レコード<sequenceNumber>1</sequenceNumber><corporateNumber>7400001010001</corporateNumber><process>01</process><correct>1</correct><updateDate>2018-05-08</updateDate><changeDate>2015-10-05</changeDate><name>株式会社フリガナ登録</name><nameImageId/><kind>301</kind><prefectureName>岩手県</prefectureName><cityName>盛岡市</cityName><streetNumber>内丸１０番１号</streetNumber><addressImageId/><prefectureCode>03</prefectureCode><cityCode>201</cityCode><postCode>0200023</postCode><addressOutside/><addressOutsideImageId/><closeDate/><closeCause/><successorCorporateNumber/><changeCause/><assignmentDate>2015-10-05</assignmentDate><latest>1</latest><enName/><enPrefectureName/><enCityName/><enAddressOutside/><furigana>フリガナトウロク</furigana></corporation></corporations>8

（応答結果の内容）
ファイル形式を XML と指定した場合、XML の最上位の構成要素である<corporations>タグの下位要素として、最終更新年月日(<lastUpdateDate>)、総件数(<count>)、分割番号(<divideNumber>)及び分割数(<divideSize>)の４
項目からなるヘッダー情報が応答されます。
指定した法人番号の法人情報については、<corporation>の下位要素として、各データ項目値が応答されます。
データ値の内容については、ケース１と同じですので、説明を省略します。
なお、前ページでは、サンプルデータの構造を視覚的に見やすく表記していますが、実際の応答結果にはインデントや改行は含まれません。
2.3.2. 変更履歴を含める場合
リクエストの条件に、変更履歴の要否を（&history=1）と設定した場合の応答結果のサンプルです。
ケース４（ファイル形式を CSV、文字コードを Shift-JIS と指定するケース）（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/num?id=Ktest01test01&number=5150001010004&type=01&history=1（リクエスト指定条件）
条件
条件の内容&number=5150001010004
法人番号「5150001010004」の１件のみ。
応答形式は「CSV 形式/Shift-JIS(JIS 第&type=01
一・第二水準)」とする。
&history=1
変更履歴を含める。
(応答結果のサンプル）
2018-05-09,2,1,1
ヘッダー情報1,5150001010004,01,1,2018-05-08,2015-10-05,"株式会社フリガナ異動
漢字名称変更前",,301,"奈良県","奈良市","登大路町３０",,29,201,63
08213,,,,,,,2015-10-05,0,,,,,"フリガナイドウカンジメイショウヘン
１レコード
コウマエ"
2,5150001010004,11,0,2018-05-09,2018-05-09,"株式会社フリガナ異動
漢字名称変更後",,301,"奈良県","奈良市","登大路町３０",,29,201,63
08213,,,,,,,2015-10-05,1,,,,,"フリガナイドウカンジメイショウヘン
２レコード
コウゴ"
(応答結果の内容）
イ ヘッダー情報
ファイル形式を CSV と指定した場合、応答結果の１行目にヘッダー情報
として最終更新年月日、総件数、分割番号及び分割数の４項目が応答され
9

ます。
項目名
データ値
最終更新年月日2018-05-09
総件数
2
分割番号
1
分割数
1
ロ データ項目
指定した法人番号「5150001010004」について、法人名変更に係る履歴情報が１件ありますので、履歴の古い順に２レコードが応答されます。
項目名
データ値
一連番号
1
2
法人番号
5150001010004
5150001010004
処理区分
01
11
訂正区分
1
0
更新年月日
2018-05-08
2018-05-09
変更年月日
2015-10-05
2018-05-09
株式会社フリガナ異 株式会社フリガナ異商号又は名称
動漢字名称変更前
動漢字名称変更後
商号又は名称イメージ ID

法人種別
国内所在地（都道府県）
国内所在地（市区町村）
国内所在地（丁目番地等）
国内所在地イメージ ID
都道府県コード
市区町村コード
郵便番号
国外所在地
国外所在地イメージ ID
登記記録の閉鎖等年月日
登記記録の閉鎖等の事由
承継先法人番号
変更事由の詳細
法人番号指定年月日
最新履歴
商号又は名称（英語表記）

301
奈良県
奈良市
登大路町３０301
奈良県
奈良市
登大路町３０29
201
630821329
201
63082132015-10-05
0

2015-10-05
1

国内所在地（都道府県）（英語表記）

10

項目名

データ値

国内所在地（市区町村丁目番地
等）（英語表記）

国外所在地（英語表記）
フリガナ※

フリガナイドウカン
ジメイショウヘンコ
ウマエ

フリガナイドウカン
ジメイショウヘンコ
ウゴ「最新履歴」のデータ値「１」は、そのデータが最新情報であること、「０」の場合は、過去の情報であることを意味します。

ケース５（ファイル形式を CSV、文字コードを Unicode と指定するケース）（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/num?id=Ktest01test01&number=5150001010004&type=02&history=1（リクエスト指定条件）
条件
条件の内容&number=5150001010004
法人番号「5150001010004」の１件のみ。
応答形式は「CSV 形式/Unicode(JIS 第一水&type=02
準から第四水準)」とする。
&history=1
変更履歴を含める。
（応答結果のサンプル）
応答結果については、ケース４と同じ値が、指定した文字コード（Unicode）
で応答されます。
（応答結果の内容）
応答結果の内容については、ケース４と同様です。
ケース６（ファイル形式を XML と指定するケース）（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/num?id=Ktest01test01&number=5150001010004&type=12&history=1（リクエスト指定条件）
条件
条件の内容&number=5150001010004
法人番号「5150001010004」の１件のみ。
応答形式は「XML 形式/Unicode(JIS 第一水&type=12
準から第四水準)」とする。
&history=1
変更履歴を含める。

11

（応答結果のサンプル）[XML Editor で開いた場合の表示]<?xml version="1.0" encoding="UTF-8"?><corporations><lastUpdateDate>2018-05-09</lastUpdateDate>
ヘッダー情報<count>2</count><divideNumber>1</divideNumber><divideSize>1</divideSize><corporation>
１レコード目<sequenceNumber>1</sequenceNumber><corporateNumber>5150001010004</corporateNumber>（中略）<furigana>フリガナイドウカンジメイショウヘンコウマエ</furigana></corporation><corporation>
２レコード目<sequenceNumber>2</sequenceNumber><corporateNumber>5150001010004</corporateNumber>（中略）<furigana>フリガナイドウカンジメイショウヘンコウゴ</furigana></corporation></corporations>（応答結果の内容）
ファイル形式を XML と指定した場合、XML の最上位の構成要素である<corporations>タグの下位要素として、最終更新年月日(<lastUpdateDate>)、総件数(<count>)、分割番号(<divideNumber>)及び分割数(<divideSize>)の４
項目からなるヘッダー情報が応答されます。
指定した法人番号の法人情報については、<corporation>の下位要素として各データ項目値が応答されます。
ケース６の場合、該当するレコードが２レコードありますので、<corporation>タグは２回繰り返し応答されます。
データの内容については、ケース４と同じです。
2.4. 一連番号の設定（ソート順）
法人番号を指定して情報を取得する機能で提供するデータは①法人番号の昇順、②変更履歴の古い順（変更履歴を取得する場合のみ）にソートして、
一連番号を設定しています。

12

３.

取得期間を指定して情報を取得する機能について

3.1.

取得期間を指定して情報を取得する機能の概要

取得期間を指定して情報を取得する機能では、取得期間を指定してリクエストを送信（「3.2.リクエストのフォーマット」に記載のフォーマットに基づいて、Web-API に送信）することで、条件に指定した期間における法人番号の新規指定、商号・所在地の変更及び登記記録の閉鎖等の事由に係る情報を、指定したファイル形式及び文字コードで取得することができます。
また、任意の条件設定項目（所在地（都道府県・市区町村）及び法人種別）を条件に追加することで、取得する情報を絞り込むこともできます。
なお、期間を指定して情報を取得する機能では、Web-API の公開後の差分データしか取得できませんので、全件データが必要な場合は、法人番号公表
サイトのダウンロード機能により取得してください。
Web-API の Ver.3.0 では、Ver.2.0 の応答結果に加え、商号又は名称に対するフリガナ情報も取得することができます。
3.2. リクエストのフォーマット
取得期間を指定して情報を取得する機能のリクエストのフォーマットは以下のとおりです。四角で囲った「バージョン」、「アプリケーション ID」、
「取得期間開始日」、「取得期間終了日」、「応答形式」及び「条件（１～Ｎ）」にセットする値について説明します。
https://api.houjin-bangou.nta.go.jp/バージョン/diff?id=アプリケーシ
ョン ID&from=取得期間開始日&to=取得期間終了日&type=応答形式&条件１&
条件２…&条件Ｎ

3.2.1. バージョン
バージョンは、Web-API のバージョン値で、「３（半角）」をセットします。
バージョンアップの方針
13

提供するデータ項目や抽出条件に追加や変更があった場合などに、バージョンアップすることとなりますが、基本方針としては、下位のバージョンと、上位のバージョンを並行して稼働させることを前提としています。
バージョンアップ情報の事前連絡
バージョンアップの予定については、事前に十分な準備期間を確保した上で法人番号公表サイトを通じてお知らせするとともに、アプリケーショ
ン ID の発行届出時に記載又は入力いただいた電子メールアドレス宛に、バージョンアップに係る情報を配信することを予定しています。
3.2.2. アプリケーション ID
アプリケーション ID は、アプリケーション ID 発行届出後、国税庁がメー
ルによりお知らせするアプリケーション ID（13 桁）をセットします。
3.2.3. 条件
条件は、①取得期間開始日、②取得期間終了日、③応答形式、④所在地、⑤法人種別、⑥分割番号という６つの項目について、下表の各項目 ID に対応する項目値を、「項目 ID＝項目値」の形式でセットし、「＆」で繋ぐことで、設定することができます。
項目【必須/任意】

取得期間
開始日

項目 ID

from

【必須】

取得期間
終了日
【必須】

to

項目値

項目値の説明取得の対象とする更新年月日の開始日を指定します。
例えば「&from=2018-05-09」とセットすると、
平成 30 年５月９日から次の「取得期間終了日」
で指定した日までのデータを取得することがで
YYYY-MM-DD きます。
なお、Web-API の本番サービス開始日（平成27年12月１日）より前の日付を指定すると、エラー(エラーコード013：取得期間開始日は2015-12-01 以降を指定してください。)となりますのでご留意ください。
取得の対象とする更新年月日の終了日を指定します。
なお、取得期間の指定可能な最大日数は 50
YYYY-MM-DD 日のため、終了日は取得期間開始日から 50 日以内の任意の日を指定して下さい。
例えば「&to=2018-06-27」とセットすると、
上記の「取得期間開始日」で指定した日から、
14

項目【必須/任意】

項目 ID

項目値

項目値の説明平成 30 年６月 27 日までのデータを取得することができます。

‐
応答形式
【必須】

type
01
02
12

‐

所在地
【任意】

address

01‐47
,99

01101
‐
47382

リクエストに対して応答するデータのファイ
ル形式と文字コードを指定します。
「&type=01」とセットした場合、ファイル形
式は CSV、文字コードは Shift-JIS(JIS 第一・第二水準)に縮退されたデータが応答されます。
CSV 形式/Shift-JIS(JIS 第一・第二水準)
CSV 形式/Unicode(JIS 第一水準から第四水準)
XML 形式/Unicode(JIS 第一水準から第四水準)
国内所在地の都道府県コード又は都道府県コードと市区町村コードを組み合わせたコードのいずれかを指定することができます。
市区町村コードのみではエラー(エラーコー
ド 051：所在地は２桁又は５桁で指定してください。)となりますので、ご留意ください。
国外所在地を指定する場合は「&address=99」と指定します。
具体的には、「&address=01101」と指定した場
合には、北海道札幌市中央区の公表情報が応答されることとなります。
都道府県コード[２桁]（JIS X 0401）をセットします。
国外所在地を指定する場合は「99」をセットします。
都道府県コードの詳細については、以下のURL※（日本産業標準調査会/データベース検索）を参照のこと。
※（https://www.jisc.go.jp/[外部サイト]）
都道府県コード[２桁]（JIS X 0401）＋市区
町村コード[３桁]（JIS X 0402）
都道府県コード及び市区町村コードの詳細については、以下の URL※（日本産業標準調査会/
データベース検索）を参照のこと。
※（https://www.jisc.go.jp/[外部サイト]）
15

項目【必須/任意】

項目 ID

項目値

‐
法人種別
【任意】

分割番号
【任意】

kind

divide01
02
03
04
1‐99999

項目値の説明法人種別を指定することができます。
カンマ区切りで複数の法人種別を指定します
が、最大４種類までとなっています。
何も指定しない場合は、４種類の全ての法人種別が含まれたデータが応答されます。
国の機関
地方公共団体設立登記法人
外国会社等・その他
分割番号を指定します。
指定しない場合は、「１」として処理されます。

「応答形式」で設定したファイル形式で、データが応答されます。応答されたデータについては、「リソース定義書」の「提供項目_Web-API（ver3）」
欄に「○」が記載されている項目をご覧ください。
3.3. 取得期間を指定して情報を取得する機能のリクエスト例とサンプルデータについて平成 30 年５月９日の差分データのみを指定して取得する場合のリクエス
ト例と、応答結果のサンプルです。
なお、リクエスト例のうち、アプリケーション ID については、説明の都合上、仮 ID（Ktest01test01）を設定しております。実際のリクエスト時にはご利用いただけませんのでご留意ください。
ケース７（ファイル形式を CSV、文字コードを Shift-JIS と指定するケース）（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/diff?id=Ktest01test01&from=2018-05-09&to=2018-05-09&type=01（リクエスト指定条件）
条件
条件の内容
平成 30 年５月９日の更新データを取得す&from=2018-05-09&to=2
る。
018-05-09&type=01

応答形式は「CSV 形式/Shift-JIS(JIS 第
一・第二水準)」とする。

16

（応答結果のサンプル）
ヘッダー情報2018-05-09,8,1,1
1,2100001010003,01,1,2018-05-09,2015-10-05,"株式会社所在地変更後
フリガナ登録,,301,"長野県","長野市","大字南長野字幅下６９２－２",,
20,201,3800837,,,,,,,2015-10-05,0,,,,,"ショザイチヘンコウゴフリガ
１レコード目
ナトウロク"（中略）
8,9380001010002,11,1,2018-05-09,2018-05-08,"株式会社漢字名称変更
後フリガナ登録",,301,"福島県","福島市","杉妻町２－１６",,07,201,96
08065,,,,,,,2015-10-05,1,,,,,"カンジメイショウヘンコウゴフリガナト
最終レコードウロク"（応答結果の内容）
イ ヘッダー情報
ファイル形式を CSV と指定した場合、応答結果の１行目にヘッダー情報
として最終更新年月日、総件数、分割番号及び分割数の４項目が応答され
ます。
項目名
データ値
最終更新年月日2018-05-09
総件数
8
分割番号
1
分割数
1
ロ データ項目
ヘッダー情報以外のデータの内容については、「リソース定義書」にて、「提供項目_Web-API（ver3）」欄に「○」が記載されている項目をご確認いただくか、別途提供しているサンプルデータの解説資料（以下「サンプルデータの説明」といいます。）をご参照ください。
なお、サンプルデータに関する説明は、「Web-API の利用手続について（共通編）―公表サイト―」の「６．サンプルデータの掲載について」をご確認ください。
ケース８（ファイル形式を CSV、文字コードを Unicode と指定するケース）（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/diff?id=Ktest01test01&from=2018-05-09&to=2018-05-09&type=02（リクエスト指定条件）
条件
条件の内容
平成 30 年５月９日の更新データを取得する。
&from=2018-05-09&to=2
018-05-09
17

条件&type=02

条件の内容
応答形式は「CSV 形式/Unicode(JIS 第一水準から第四水準)」とする。

（応答結果のサンプル）
応答結果については、ケース７と同じ値のデータが、指定した文字コード（Unicode）で応答されます。
（応答結果の内容）
応答結果の内容については、「リソース定義書」にて、「提供項目_Web-API（ver3）」欄に「○」が記載されている項目をご確認いただくか、「サンプルデータの説明」をご参照ください。
ケース９（ファイル形式を XML と指定するケース）（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/diff?id=Ktest01test01&from=2018-05-09&to=2018-05-09&type=12（リクエスト指定条件）
条件
条件の内容
平成 30 年５月９日の更新データを取得する。
&from=2018-05-09&to=2
018-05-09&type=12

応答形式は「XML 形式/Unicode(JIS 第一水準から第四水準)」とする。

18

（応答結果のサンプル）[XML Editor で開いた場合の表示]<?xml version="1.0" encoding="UTF-8"?><corporations>
ヘッダー情報<lastUpdateDate>2018-05-09</lastUpdateDate><count>8</count><divideNumber>1</divideNumber><divideSize>1</divideSize><corporation><sequenceNumber>1</sequenceNumber><corporateNumber>2100001010003</corporateNumber>（中略）<enCityName/><enAddressOutside/><furigana>ショザイチヘンコウゴフリガナトウロク</furigana>１レコード目</corporation>（中略）<corporation><sequenceNumber>8</sequenceNumber><corporateNumber>9380001010002</corporateNumber>（中略）<enCityName/><enAddressOutside/><furigana>カンジメイショウヘンコウゴフリガナトウロク</furigana></corporation>
最終レコード</corporations>（応答結果の内容）
ファイル形式を XML と指定した場合、XML の最上位の構成要素である<corporations>タグの下位要素として、最終更新年月日(<lastUpdateDate >)、総件数(<count>)、分割番号(<divideNumber>)及び分割数(<divideSize>)の４
項目のヘッダー情報が応答されます。
ケース９の場合、該当するレコードが８レコードありますので、<corpora
tion>タグは８回応答されます。
応答結果の内容については、「リソース定義書」にて、「提供項目_Web-API（ver3）」欄に「○」が記載されている項目をご確認いただくか、「サンプルデータの説明」をご参照ください。

19

3.4. 一連番号の設定（ソート順）
取得期間を指定して情報を取得する機能で提供するデータは、①更新年月日（昇順）及び②法人番号（昇順）の順にソートし、一連番号を設定します。
3.5. 応答結果の分割について
取得期間を指定して情報を取得する機能では、大容量データの送信による性能低下を防止する観点から、応答結果が 2,000 件を超過する場合に、リク
エストの応答結果を分割して提供します。
応答結果の分割では、分割されたファイルの総数（分母）にあたるデータ
項目を「分割数」と定義し、分割されたファイルの通し番号（分子）を表す
データ項目を「分割番号」と定義しています。
Web-API を利用される際は、最初のリクエストの分割番号に「１」をセットします。
なお、分割番号に値を設定しない場合は、分割番号を「１」として処理されます。
リクエストの送信後、応答されるデータのヘッダー項目にある分割数の値を参照していただき、分割数の値が「１」以外の場合は、応答結果が分割されていますので、分割番号が分割数と一致するまで分割番号をカウントアッ
プしてリクエストを送信することで、リクエスト条件に合致する全ての情報を取得することができます。
図

応答結果の分割時の処理イメージ

20

４.

法人名を指定して情報を取得する機能について

4.1.

法人名を指定して情報を取得する機能の概要

法人名を指定して情報を取得する機能は、Ver.2.0 から新たに提供している機能です。法人名を指定してリクエストを送信（「4.2.リクエストのフォー
マット」に記載のフォーマットに基づいて、Web-API に送信）することで、条件に指定した法人の基本３情報を、指定したファイル形式及び文字コードで取得することができます。
また、任意の条件設定項目（所在地（都道府県・市区町村）及び法人種別等）を指定することにより、取得する情報を絞り込むことができます。
Web-API の Ver.3.0 では、Ver.2.0 の応答結果に加え、商号又は名称に対するフリガナ情報も取得することができます。
4.2. リクエストのフォーマット
法人名を指定して情報を取得する機能のリクエストのフォーマットは以下のとおりです。四角で囲った「バージョン」、「アプリケーション ID」、「商号又は名称」、「応答形式」及び「条件（１～Ｎ）
」にセットする値について説明します。
https://api.houjin-bangou.nta.go.jp/バージョン/name?id=アプリケーシ
ョン ID&name=商号又は名称&type=応答形式&条件１&条件２…&条件Ｎ
4.2.1. バージョン
バージョンは、Web-API のバージョン値で、「３（半角）」をセットします。
バージョンアップの方針
提供するデータ項目や抽出条件に追加や変更があった場合などに、バージョンアップすることとなりますが、基本方針としては、下位のバージョンと、上位のバージョンを並行して稼働させることを前提としています。

21

バージョンアップ情報の事前連絡
バージョンアップの予定については、事前に十分な準備期間を確保した上で法人番号公表サイトを通じてお知らせするとともに、アプリケーショ
ン ID の発行届出時に記載又は入力いただいた電子メールアドレス宛に、バージョンアップに係る情報を配信することを予定しています。
4.2.2. アプリケーション ID
アプリケーション ID は、アプリケーション ID 発行届出後、国税庁がメー
ルによりお知らせするアプリケーション ID（13 桁）をセットします。
4.2.3. 条件
条件は、①商号又は名称、②応答形式、③商号又は名称検索方式、④商号
又は名称検索対象、⑤所在地、⑥法人種別、⑦変更履歴、⑧登記記録の閉鎖
等、⑨法人番号指定年月日開始日、⑩法人番号指定年月日終了日、⑪分割番号という 11 の項目について、下表の各項目 ID に対応する項目値を、「項目ID＝項目値」の形式でセットし、「＆」で繋ぐことで、設定することができます。
なお、下表の各項目欄に【必須】と記載されている条件は必ず設定してください。
項目【必須/任意】

商号又は
名称
【必須】

項目 ID

name

項目値

項目値の説明‐取得の対象とする法人名を URL エンコード（UTF-8）した値をセットします。
例えば「国税庁」を URL エンコード（UTF-8）
した場合、「%E5%9B%BD%E7%A8%8E%E5%BA%81」となり、これをリクエストにセットすると、国税庁のデータを取得することができます。
（注１）複数の法人名はセットできません。
（注２）法人種別及び名称に使用されている文字（漢字、ひらがな、カタカナ、アルファベッ
ト、数字等）はすべて URL エンコード（UTF-8）する必要がありますが、後述する「商号又は名称検索対象」で「１」又は「２」を選択した場
合は全角文字、「商号又は名称検索対象」で「３」を選択した場合は半角文字を URL エンコード（UTF-8）してください。
（注３）「商号又は名称検索方式」で「１」を設定する場合は、法人種別を除いた上で法人名をURL エンコード（UTF-8）してください。
22

項目【必須/任意】

項目 ID

項目値

‐
応答形式
【必須】

type
01
02
12

商号又は
名称
検索方式
【任意】

‐
mode

1
2

商号又は
名称
検索対象
【任意】

target‐1

項目値の説明（例）「株式会社法人ばんごうＮＵＭ１」を URL
エンコード（UTF-8）した場合%E6%A0%AA%E5%BC%8F%E4%BC%9A%E7%A4%BE%E6%B3%95%E4%BA%BA%E3%81%B0%E3%82%93%E3%81%94%E3%81%86%EF%BC%AE%EF%BC%B5%EF%BC%AD%EF%BC%91
リクエストに対して応答するデータのファイ
ル形式と文字コードを指定します。
「&type=01」とセットした場合、ファイル形
式は CSV、文字コードは Shift-JIS(JIS 第一・第二水準)に縮退されたデータが応答されます。
CSV 形式/Shift-JIS(JIS 第一・第二水準)
CSV 形式/Unicode(JIS 第一水準から第四水準)
XML 形式/Unicode(JIS 第一水準から第四水準)
検索方式を指定することができます。
「&mode=2」とセットすると、指定した法人名と部分一致するデータが応答されます。
指定しない場合は、｢１｣（前方一致検索）として処理されます。
詳細については、30 ページの「4.6. 法人名検索方式について」をご覧ください。
前方一致検索部分一致検索検索対象を指定することができます。
「&target=1」をセットすると「商号又は名称」の文字が JIS 第一・第二水準のデータベースを
あいまい検索します。
「&target=2」をセットすると「商号又は名称」の文字が JIS 第一～第四水準のデータベースを指定した文字そのままで検索します。
「&target=3」をセットすると英語表記が登録された法人の英語表記を検索対象とします。
指定しない場合は、｢１｣（JIS 第一・第二水準）として処理されます。
詳細については、30 ページの「4.6. 法人名検索方式について」をご覧ください。
JIS 第一・第二水準
23

項目【必須/任意】

項目 ID

項目値

項目値の説明2
3

JIS 第一～第四水準
英語表記
国内所在地の都道府県コード又は都道府県コードと市区町村コードを組み合わせたコードのいずれかを指定することができます。
市区町村コードのみではエラー(エラーコー
ド 051：所在地は２桁又は５桁で指定してください。)となりますので、ご留意ください。
国外所在地を指定する場合は「&address=99」と指定します。
具体的には、「&address=01101」と指定した場
合には、北海道札幌市中央区の公表情報が応答されることとなります。
都道府県コード[２桁]（JIS X 0401）をセットします。
国外所在地を指定する場合は「99」をセットします。
都道府県コードの詳細については、以下のURL※（日本産業標準調査会/データベース検索）を参照のこと。
※（https://www.jisc.go.jp/[外部サイト]）
都道府県コード[２桁]（JIS X 0401）＋市区
町村コード[３桁]（JIS X 0402）
都道府県コード及び市区町村コードの詳細については、以下の URL※（日本産業標準調査会/
データベース検索）を参照のこと。
※（https://www.jisc.go.jp/[外部サイト]）
法人種別を指定することができます。
カンマ区切りで複数の法人種別を指定します
が、最大４種類までとなっています。
何も指定しない場合は、４種類の全ての法人種別が含まれたデータが応答されます。
国の機関
地方公共団体設立登記法人
外国会社等・その他

‐

所在地
【任意】

address

01‐47
,99

01101
‐
47382

‐
法人種別
【任意】

kind
01
02
03
04

24

項目
【必須/任意】

変更履歴
【任意】

登記記録
の閉鎖等
【任意】

法人番号
指定
年月日
開始日
【任意】

項目 ID

項目値

項目値の説明法人名や所在地の変更があった法人等について過去の情報を含めて検索するかどうかを指定します。
「&change=1」をセットすると、法人名や所在地の変更があった法人等の変更履歴（変更前の法人名や所在地）を含めて検索し、合致したデータを応答します。
例えば、「商号又は名称」に変更前の法人名、「&change=1」をセットした場合、変更前の法人‐名で検索し、変更前の法人情報を応答します。
change最新の法人名の情報は返却されませんので、最新情報を取得するためには、応答結果の法人番号から法人番号を指定して情報を取得する機能を利用し、再度リクエストを送信する必要があります。
指定しない場合は、「０」（変更履歴を含めない）として処理されます。
0
変更履歴を含めない。
1
変更履歴を含める。
登記記録の閉鎖等があった法人等の情報を取得するかどうかを指定します。
「&close=0」をセットすると、登記記録の閉‐鎖等があった法人等の情報は応答しません。
close
指定しない場合は、「１」（登記記録の閉鎖等を含める）として処理されます。
0
登記記録の閉鎖等を含めない。
1
登記記録の閉鎖等を含める。
取得の対象とする法人番号指定年月日の開始日を指定します。
例えば「&from=2017-04-01」とセットすると、
平成 29 年４月１日から次の「法人番号指定年月
日終了日」で指定した日までに法人番号の指定
from YYYY-MM-DDを受けた法人等のデータを取得することができます。
なお、番号法施行日（平成 27 年 10 月５日）
より前の日付を指定すると、エラー(エラーコー
ド 152：法人番号指定年月日開始日は 2015-1025

項目【必須/任意】

項目 ID

法人番号
指定
年月日
終了日
【任意】

分割番号
【任意】

項目値

項目値の説明05 以降を指定してください。)となりますのでご留意ください。
取得の対象とする法人番号指定年月日の終了日を指定します。
例えば「&to=2017-04-01」とセットすると、
to
YYYY-MM-DD
上記の「法人番号指定年月日開始日」で指定した日から、平成 29 年４月１日までのデータを取得することができます。
divide1‐99999
分割番号を指定します。
指定しない場合は、「１」として処理されます。

4.3.

法人名を指定して情報を取得する機能のリクエスト例とサンプルデー
タについて
法人名を指定して情報を取得する機能のリクエスト例と、応答結果のサンプルについて、それぞれ説明します。
なお、リクエスト例のうち、アプリケーション ID については、説明の都合上、仮 ID（Ktest01test01）を設定しております。実際のリクエスト時にはご利用いただけませんのでご留意ください。
ケース 10 (ファイル形式を CSV、文字コードを Shift-JIS と指定するケース)（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/name?id=Ktest01test01&name=%E5%9B%BD%E7%A8%8E%E5%95%86%E4%BA%8B&change=1&type=01（リクエスト指定条件）
条件
条件の内容
法人名を「国税商事」とし、法人名を&name=%E5%9B%BD%E7%A8%8E%
URL エンコード（UTF-8）する。
E5%95%86%E4%BA%8B&change=1

検索対象に過去の情報を含める。
応答形式は「CSV 形式/Shift-JIS(JIS&type=01
第一・第二水準)」とする。
条件に「検索方式（mode）」及び「検索対象(target)」が指定されておらず、「変更履歴（change）」に「１（変更履歴を含める）」が指定されているため、セットされた「商号又は名称」について、「検索方式：前方一致、
検索対象：JIS 第一・第二水準、変更履歴：含める」として処理され、その結果が応答されます。

26

（応答結果のサンプル）
2017-05-10,10,1,1
ヘッダー情報1,2040001999902,01,0,2015-12-01,2015-10-05,"株式会社国税商事あ",,301,"千葉県","千葉市中央区","中央４丁目５番８号",,12,101,260001
１レコード目
3,,,,,,,2015-10-05,1,,,,,（中略）10,3040001999901,01,0,2015-12-01,2015-10-05,"株式会社国税商事Ａ",,301,"千葉県","千葉市中央区","中央４丁目５番９号",,12,101,260001
最終レコード3,,,,,,,2015-10-05,1,,,,,（応答結果の内容）
イ ヘッダー情報
ファイル形式を CSV と指定した場合、応答結果の１行目にヘッダー情報
として最終更新年月日、総件数、分割番号及び分割数の４項目が応答され
ます。
項目名
データ値
最終更新年月日2017-05-10
総件数
10
分割番号
1
分割数
1
ロ データ項目
ヘッダー情報以外のデータの内容については、「リソース定義書」にて、「提供項目_Web-API（ver3）」欄に「○」が記載されている項目をご確認いただくか、「サンプルデータの説明」をご参照ください。
ケース 11 (ファイル形式を CSV、文字コードを Unicode と指定するケース)（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/name?id=Ktest01test01&name=%E5%9B%BD%E7%A8%8E%E5%95%86%E4%BA%8B&change=1&type=02（リクエスト指定条件）
条件
条件の内容
法人名を「国税商事」とし、法人名を&name=%E5%9B%BD%E7%A8%8E
URL エンコード（UTF-8）する。
%E5%95%86%E4%BA%8B&change=1&type=02

検索対象に過去の情報を含める。
応答形式は「CSV 形式/Unicode(JIS 第一水準から第四水準)」とする。

（応答結果のサンプル）
応答結果については、ケース 10 と同じ値のデータが、指定した文字コード（Unicode）で応答されます。
（応答結果の内容）
27

応答結果の内容については、「リソース定義書」にて、「提供項目_Web-API（ver3）」欄に「○」が記載されている項目をご確認いただくか、「サンプルデータの説明」をご参照ください。
ケース 12 (ファイル形式を XML と指定するケース)（リクエスト例）
https://api.houjin-bangou.nta.go.jp/3/name?id=Ktest01test01&name=%E5%9B%BD%E7%A8%8E%E5%95%86%E4%BA%8B&change=1&type=12（リクエスト指定条件）
条件
条件の内容&name=%E5%9B%BD%E7%A8%
法人名を「国税商事」とし、法人名を URL
8E%E5%95%86%E4%BA%8B
エンコード（UTF-8）する。
&change=1
検索対象に過去の情報を含める。
応答形式は「XML 形式/Unicode(JIS 第一水&type=12
準から第四水準)」とする。

28

（応答結果のサンプル）[XML Editor で開いた場合の表示]<?xml version="1.0" encoding="UTF-8"?><corporations><lastUpdateDate>2017-05-10</lastUpdateDate>
ヘッダー情報<count>10</count><divideNumber>1</divideNumber><divideSize>1</divideSize><corporation><sequenceNumber>1</sequenceNumber><corporateNumber>2040001999902</corporateNumber>（中略）<enCityName/><enAddressOutside/><furigana/>
１レコード目</corporation>（中略）<corporation><sequenceNumber>10</sequenceNumber><corporateNumber>3040001999901</corporateNumber>（中略）<enCityName/><enAddressOutside/><furigana/>
最終レコード</corporation></corporations>（応答結果の内容）
ファイル形式を XML と指定した場合、XML の最上位の構成要素である<corporations>タグの下位要素として、最終更新年月日(<lastUpdateDate >)、総件数(<count>)、分割番号(<divideNumber>)及び分割数(<divideSize>)の４
項目のヘッダー情報が応答されます。
ケース 12 の場合、該当するレコードが 10 レコードありますので、<corpo
ration>タグは 10 回応答されます。
ヘッダー情報以外のデータの内容については、「リソース定義書」にて、「提供項目_Web-API(ver3）」欄に「○」が記載されている項目をご確認いただくか、「サンプルデータの説明」をご参照ください。
4.4. 一連番号の設定（ソート順）
法人名を指定して情報を取得する機能で提供するデータは、①法人名の文字コード順（昇順）（注）及び②法人番号（昇順）の順にソートし、一連番号
29

を設定します。
(注) 法人番号システムでは法人名を UTF-8 形式で保有しているため、応答形式に関係なく、UTF-8 の文字コード昇順でソートします。
また、「商号又は名称検索対象」で「３（英語表記）」を選択した上で、英語表記を指定しリクエストした場合は、「商号又は名称（英語表記）」を
UTF-8 の文字コード昇順でソートします。
4.5. 応答結果の分割について
法人名を指定して情報を取得する機能では、大容量データの送信による性能低下を防止する観点から、応答結果が 2,000 件を超過する場合に、リクエ
ストの応答結果を分割して提供します。
詳細については、「3.5. 応答結果の分割について」をご覧ください。
4.6. 法人名検索方式について
法人名を指定して情報を取得する機能では、任意条件「商号又は名称検索方式」及び「商号又は名称検索対象」を利用することで、「前方一致検索」「部
分一致検索」「あいまい検索」など、法人名の検索方式を選択することができます。
4.6.1. 商号又は名称検索方式
前方一致検索検索する際に、「株式会社」や「有限会社」などの法人種別を除いた法人
名の先頭から参照し、指定した文字列から始まる名称の法人情報を取得することができます。
（例）法人名に「国税」を指定し、前方一致検索した場合

30

部分一致検索検索する際に、法人名全体を参照し、指定した文字列を含む名称の法人の情報を取得することができます。部分一致検索では法人種別（株式会
社、有限会社など）を除く必要はありません。
（例）法人名に「国税」を指定し、部分一致検索した場合

4.6.2. 商号又は名称検索対象
JIS 第一・第二水準「商号又は名称」の文字について JIS 第一・第二水準に縮退され、あいまい検索に対応したデータベースを指定した法人名で検索します。
あいまい検索では、指定された法人名について①ひらがなをカタカナに置き換え②英小文字（ａｂｃ）を英大文字（ＡＢＣ）に置き換え③「・（中点）」や全角スペースを削除など、指定された文字列を補正した上で検索することにより、類似した法人名の法人情報を抽出することができます。

31

（例）法人名に「こく・ぜい」を指定し、JIS 第一・第二水準を検索対象とした場合（検索方式は「部分一致検索」を選択）

JIS 第一～第四水準「商号又は名称」の文字について JIS 第一～第四水準のデータベースを指定した法人名で検索します。ここではに記載したあいまい検索は行いませんので、指定した文字列を名称に含んだ法人情報のみを抽出することができます。
（例）法人名に「こく・ぜい」を指定し、JIS 第一～第四水準を検索対象とした場合（検索方式は「部分一致検索」を選択）

英語表記
英語表記が登録された法人について名称の英語表記を指定した英語名称
であいまい検索します。
ここでは、指定された英語名称について①英小文字（ａｂｃ）を英大文字（ＡＢＣ）に置き換え②「,（カンマ）」や半角スペースを削除など、指定された文字列を補正した上で検索します。

32

（例）法人名に「a&b Inc.」を指定し、英語表記を検索対象とした場合（検索方式は「部分一致検索」を選択）

33

５. エラーコード及び HTTP ステータスコード
リクエストに誤りがある場合などには、HTTP ステータスコードのほか、エラーの詳細についてわかるように、エラーコード及びエラーメッセージがCSV 形式で応答されます。
エラー情報が返却された場合は、「別紙２ HTTP ステータスコード、エラ
ーコード及びエラーメッセージ一覧」の内容を確認していただき、リクエス
ト指定条件を修正するなどして、リクエストを再送信してください。

34

別紙１

リソース定義書（ダウンロードファイル、Web-API）－公表サイト－4.1版
令和３年２月
国税庁 法人番号管理室

改版履歴
項番

版数

変更箇所

変更内容

変更理由等

1

初版

－

－

－

2

3

4

5

2.0版

3.0版

4.0版

4.1版

英語表記登録の開始に伴い、新たにWeb-API（Ver.2.0）をリリースすることから、本書を改訂。

全体

・Web-API（Ver.2.0）の追加
・ダウンロードファイル及びWeb-API（Ver.2.0）のデータ項目に商号・所在地（英語表記）追加（項番31～34）。

フリガナ項目の追加に伴い、新たにWeb-API（Ver.3.0）をリリースすることから、本書を改訂。

項目追加

・Web-API（Ver.3.0）の追加
・ダウンロードファイル及びWeb-API（Ver.3.0）のデータ項目に商号又は名称に対するフリガナ情報を追加（項番35）。

検索対象除外の項目の追加に伴い、新たにWebAPI（Ver.4.0）をリリースすることから、本書を改訂。

項目追加

・Web-API（Ver.4.0）の追加
・ダウンロードファイル及びWeb-API（Ver.4.0）のデータ項目に検索対象除外の情報を追加（項番36）。
・データベースが更新される日時を変更（項番２）。

法人情報が更新される日時の変更に伴い、本書を
改訂。

全体

改版履歴
項番

版数

変更箇所

変更内容

変更理由等

1

初版

－

－

－

2

3

4

5

2.0版

3.0版

4.0版

4.1版

英語表記登録の開始に伴い、新たにWeb-API（Ver.2.0）をリリースすることから、本書を改訂。

全体

・Web-API（Ver.2.0）の追加
・ダウンロードファイル及びWeb-API（Ver.2.0）のデータ項目に商号・所在地（英語表記）追加（項番31～34）。

フリガナ項目の追加に伴い、新たにWeb-API（Ver.3.0）をリリースすることから、本書を改訂。

項目追加

・Web-API（Ver.3.0）の追加
・ダウンロードファイル及びWeb-API（Ver.3.0）のデータ項目に商号又は名称に対するフリガナ情報を追加（項番35）。

検索対象除外の項目の追加に伴い、新たにWebAPI（Ver.4.0）をリリースすることから、本書を改訂。

項目追加

・Web-API（Ver.4.0）の追加
・ダウンロードファイル及びWeb-API（Ver.4.0）のデータ項目に検索対象除外の情報を追加（項番36）。
・データベースが更新される日時を変更（項番２）。

法人情報が更新される日時の変更に伴い、本書を改訂。

全体

リソース定義書（目次）
項目名

項番

Web-API機
能で情報を
取得した際
にヘッダー
情報として
出力される
項目。

名称

リソース名

ページ

項目名

項番

名称

リソース名

1

ルート要素

corporations19

国内所在地イメージID

addressImageId2

最終更新年月日

lastUpdateDate

20

都道府県コード

prefectureCode

3

総件数

count

21

市区町村コード

cityCode

ページ
5

1
4

分割番号

divideNumber

22

郵便番号

postCode5

分割数

divideSize

23

国外所在地

addressOutside

6

法人等要素

corporation

24

国外所在地イメージID

addressOutsideImageId

7

一連番号

sequenceNumber

25

登記記録の閉鎖等年月日

closeDate26

登記記録の閉鎖等の事由

closeCause27

承継先法人番号successorCorporateNumber

28

変更事由の詳細changeCause

6

2
8

法人番号

corporateNumber

9

処理区分

process10

訂正区分

correct

2～3

7

3
11

更新年月日

updateDate

29

法人番号指定年月日

assignmentDate

12

変更年月日

changeDate

30

最新履歴

latest13

商号又は名称name

31

商号又は名称（英語表記）

enName14

商号又は名称イメージID

nameImageId

15

法人種別

kind

16

国内所在地（都道府県）

prefectureName

17

国内所在地（市区町村）

cityName

18

国内所在地（丁目番地等）

streetNumber

4

32

4～5

5

33

国内所在地（都道府県）（英enPrefectureName
語表記）
国内所在地（市町村丁目番
enCityName
地等）（英語表記）

34

国外所在地（英語表記）

enAddressOutside

35

フリガナ

furigana36

検索対象除外hihyoji8リソース定義書の見方
・公表サイトの基本３情報画面よりダウンロードしたダウンロードファイル及びWeb-API（Ver.1～Ver.4）により取得したデータには、項目名が入っておりませんので、各データが何を意味するのか確認したい場合に本書をご利用ください。
・ダウンロードファイルの場合、本書１ページ以降の「提供項目_ダウンロード」欄に「○」が入ったデータ項目が格納されています。
・Web－APIの場合、各バージョンに応じて、本書１ページ以降の「提供項目_ver1～ver4」のいずれかの欄に「○」が入ったデータ項目が格納されています。

凡例
凡例

項番

凡例の説明

出力項目値のエスケープについて(１) CSV形式

インターネットの技術標準を議論するIETFによる、RFC3339に則った形式。

YYYY-MM-DD 平成27年10月5日（2015年10月5日）の場合は、「2015-10-05」と設定する。

凡例

Z

0から9の半角数字を意味する。上位（左側）の桁が「0」の場合には、設定されない。

9

NULL値でない場合、上位（左側）の桁の有無に関わらず、0から9の半角数字が設定される。

CSV形式におけるエスケープ対象文字について「表1」に示す。

(２) XML形式

全角文字

XML形式におけるエスケープ対象文字について「表2」に示す

全半角混在
CSV形式で取得する場合、ダブルクォーテーション「"」で囲む。

半角英数記号
半角英字

表1CSV形式エスケープ対象文字
対象文字
エスケープシーケンス
"
""

№
1

№
1

表2CSV形式エスケープ対象文字
対象文字
エスケープシーケンス
＆
&amp;
<
&lt;
>
&gt;

リソース定義書（ダウンロードファイル等）
データ形式等

項目名
項番
名称

1 ルート要素

2

最終更新
年月日

3 総件数

4 分割番号

リソース名

形式(凡例参照)

corporations

項目値
桁数

-

-

コード

-

項目値
名称
-

提供項目
ダウン
ロード ver1

○

○

項目の説明

Web-APIver2○

ver3 ver4○○

lastUpdateDate

YYYY‐MM‐DD

10

-

-

-

○

○

○

○

count

ZZZZZZZ9

１～8

-

-

-

○

○

○

○

divideNumber

5 分割数

divideSize

6 法人等要素

corporation

ZZZZ9

1～5

ZZZZ9

-

-

-

-

○

○

○

○

1～5

-

-

-

○

○

○

○

-

-

-

○

○

○

○

○

1

ルート要素は、XML文書に必要な要素で、XML文書のデータ階層構造の最上位に位置する要素。
このルート要素は、CSV形式で取得する場合は設定されない（XMLのみ）。
Web-APIで情報を取得した際に、ヘッダー情報として、出力される情報（WebAPIの検索条件で参照する項目ではない。）。
この最終更新年月日は、公表用のデータベースを最後に更新した日付を表す。
データベースの更新処理は、当日の11時及び16時の２回実施する（処理状況によっては遅れる場合がある。）。
データベース更新処理実施後から午前０時の日付切替処理までの時間帯においては、国税庁法人番号公表サイトでの検索、ダウンロード及びWeb-APIの法人番号・法人名を指定して情報を取得する機能により、更新情報を取得することができる。
なお、当日分の全ての更新情報についてWeb-APIを利用して取得したい場合
は、取得期間を指定して情報を取得する機能により、午前０時の日付切換処理
後に前日の日付をセットして取得することができる。
Web-APIで情報を取得した際にヘッダー情報として出力される情報。
総件数は、Web-APIで指定した条件に合致したデータの総件数を表す。
Web-APIの取得期間や法人名を指定して情報を取得する場合の一度に取得することができるデータ件数を2,000件に制限するため、条件に合致するデータを取得する際にファイルが分割されることがある。
分割番号は、その際の分割数の分子を表すデータ項目。
次項の分割数と当該データ項目（分割番号）が一致するまでWeb-APIリクエス
ト条件の分割番号をカウントアップしてリクエストを送信することにより、条件に合致する情報を全て取得することができる。
Web-APIで情報を取得した際にヘッダー情報として出力される情報。
分割数は、分割番号の分母を表すデータ項目。
条件に合致する情報（ファイル）の取得において分割されない場合、値が「1」となる。
法人等要素は、XML文書のデータ階層構造上、項番7「一連番号」から項番36「検索対象除外」までの上位に位置する親要素。
法人等要素は、CSV形式で取得する場合は設定されない（XMLのみ）。

リソース定義書（ダウンロードファイル等）
データ形式等

項目名
項番
名称

形式
(凡例参照)

リソース名

項目値
桁数

コード

項目値
名称

提供項目
ダウン
ロード ver1

項目の説明

Web-APIver2

ver3 ver4

7 一連番号

sequenceNumber ZZZZZZZ9

1～8

-

-

○

○

○

○

○

8 法人番号

corporateNumber 9999999999999

13

-

-

○

○

○

○

○

-

9 処理区分process99

全件データ（月末時点の最新情報）やWeb-APIによる法人番号を指定した最新情報の取得以外の場合（例えば、ある法人の情報を履歴情報を含めて取得する場合や、日次の更新情報を取得する場合。）には、同一法人に関する情報が複数存在することがある。
その際に、法人（法人番号）単位に時系列の更新処理等を行う場合、一連番号が小さい値の情報から順番に処理することにより、時系列に順序性を保って更新処理を行うことを可能とするための項目。
なお、ダウンロードでは、１ファイルのファイルサイズが過度に大きくなる場合にファイルが分割して提供され、Web-APIではデータ件数が2,000件を超過した
場合にデータが分割して提供されるが、いずれの場合も、一連番号は、データ全体を通じて付される。
法人番号の指定を受けた者（以下「法人番号保有者」という。）の法人番号を示すデータ項目。
法人番号の指定、商号又は所在地に変更等が発生した事由をコード値で表す項目。
※英語表記及びフリガナの登録並びに検索対象除外の情報の更新に係る処理区分はありません（これらの項目は、提供済みのデータに英語表記若しくはフリガナの登録又は検索対象除外の情報を追加した上で、訂正データとして提供す
るため）。

-

値「01」は、新たに法人番号が指定されたことを表す情報であることを意味す
る。

01

新規

11

商号又は
名称の変更

12

国内所在地
の変更

13

国外所在地
の変更

値「13」は、国外における本店又は主たる事務所の所在地が変更されたことを表す情報であることを意味する。

21

登記記録
の閉鎖等

値「21」は、清算の結了、合併による解散などの事由により登記記録の閉鎖等の事由が生じたことを表す情報であることを意味する。

22

登記記録
の復活等

値「22」は、清算の結了、合併による解散などの事由により登記記録の閉鎖等が生じた後、清算結了等の手続に瑕疵があり、清算結了が無効になるなどの事由により登記記録が復活等したことを表す情報であることを意味する。

2

値「11」は、商号又は名称が変更されたことを表す情報であることを意味する。

○

○

2

○

○

○

値「12」は、国内における本店又は主たる事務所の所在地の変更、国内に本店又は主たる事務所がない法人等の場合は、国内における事務所又は営業所の所在地の変更又は、市区町村合併等により住居表示が変更されたことを表す情報であることを意味する。

リソース定義書（ダウンロードファイル等）
データ形式等

項目名
項番
名称

9 処理区分

形式(凡例参照)

リソース名

process

99

項目値
桁数

2

コード

項目値
名称

71

吸収合併

72

吸収合併無
効

81

商号の登記
の抹消

99

提供項目
ダウン
ロード ver1

項目の説明

Web-APIver2

ver3 ver4
値「71」は、設立登記法人が、吸収合併を行ったことを表す情報であることを意味する。
値「72」は、吸収合併後存続した設立登記法人の吸収合併について無効判決が確定したことを表す情報であることを意味する。

○

○

○

○

○

値「81」は、設立登記法人について商号の登記が抹消されたことを表す情報であることを意味する。
値「99」は、法人番号の重複指定等の理由により法人番号の指定を撤回した
こと及び公表に同意した人格のない社団等の代表者又は管理人が、公表の同意を撤回したことを表す情報であることを意味する。
値「99」が設定された場合は、「一連番号」、「法人番号」及び「更新年月日」を除く全ての項目値はブランクとなる。

削除

提供していたデータについて、次の場合に値を設定するデータ項目。
① 履歴データ（過去分含む。）の内容に誤りがあり、訂正が生じた場合② 履歴データの追加が生じた場合③ 履歴データの削除が生じた場合④ 英語表記の登録情報を提供する場合⑤ フリガナの登録情報を提供する場合⑥ 検索対象除外の情報を提供する場合
10 訂正区分

correct

9

-

1

○

0

訂正以外

1

訂正

○

○

○

○

処理区分が「99：削除」の場合は、訂正区分はブランクとなる。
内容に誤りがあった場合は、当該データ項目を活用し、誤った内容のデータを削除して、訂正データを取り込むことにより、保有データを訂正することができる。
なお、訂正処理があった場合は、訂正した法人番号保有者に係る全ての履歴
データを提供している。
訂正したデータ（訂正区分が「1」）以外の場合、当該訂正区分に訂正以外「0」を設定する。
訂正したデータの場合、当該訂正区分に訂正「1」を設定する。
法務省等からデータを受け取り、当庁でデータを更新した日付を表す。

11 更新年月日

updateDate

YYYY‐MM‐DD

10

-

-

○

○

3

○

○

○

リソース定義書（ダウンロードファイル等）
データ形式等

項目名
項番
名称

形式
(凡例参照)

リソース名

項目値
桁数

コード

項目値
名称

提供項目
ダウン
ロード ver1

項目の説明

Web-APIver2

ver3 ver4事由が発生した日付を表すデータ項目。
○処理区分が新規（01）の場合
法人番号が指定された年月日を意味する。

12 変更年月日

13 商号又は名称

14changeDate

name

商号又は
nameImageId
名称イメージID

15 法人種別kind

YYYY‐MM‐DD

全角文字

99999999

999

10

150
(最大)

8

-

-

-

-

-

-

-

-

101

国の機関

201

地方公共
団体

3
301

○

○

○

○

○

○

○

○

○

○

○

○

○

○処理区分が新規（01）以外の場合
・設立登記法人：処理区分の事由に係る登記年月日を意味する。
・設立登記法人以外：処理区分の事由が生じた年月日を意味する。

○

法人番号保有者の商号又は名称を示すデータ項目。
商号又は名称の文字数が、150文字を超過した場合、151文字目以降の文字は格納されないため、151文字目以降の情報は、イメージファイルを閲覧することにより確認することができる。

○

商号又は名称イメージIDは、イメージファイルを閲覧するために指定する値（情報）。
当該データ項目は、商号又は名称にJIS第１・第２水準以外の文字を使用している場合及び商号又は名称の文字数が150文字を超過した場合に値を設定する項目。
なお、当該イメージIDの値を設定したURL※でアクセスすることにより、国税庁
法人番号公表サイトの検索画面で確認できるイメージファイルと同様のイメージ
ファイルを直接閲覧することができる。
※（https://www.houjin-bangou.nta.go.jp/image?imageid=イメージID）
各システムの画面にイメージファイルを表示したいなどの要件がある場合に活用することができる。
法人種別を判別するためのデータ項目。
例えば、データの取込み処理を行う場合などにおいて、処理対象として必要としない法人（組織区分）のデータを、法人種別のコード値を利用して除外設定を行うなどの活用が考えられるために提供する項目。
コード化した法人種別は、以下のとおり。
値「101」は、行政機関、裁判所及び国会の機関に係る情報であることを意味する。
値「201」は、地方自治法第１条の３において定義されている普通地方公共団
体及び特別地方公共団体に係る情報であることを意味する。

○

○

株式会社

4

○

○

○

値「301」は、株式会社の情報であることを意味する。

リソース定義書（ダウンロードファイル等）
データ形式等

項目名
項番
名称

形式
(凡例参照)

リソース名

項目値
桁数

コード

項目値
名称

302

有限会社

303

合名会社

304

合資会社

305

合同会社

399

その他の
設立登記法
人

提供項目
ダウン
ロード ver1

項目の説明

Web-APIver2

ver3 ver4
値「302」は、特例有限会社の情報であることを意味する。
値「303」は、合名会社の情報であることを意味する。
値「304」は、合資会社の情報であることを意味する。
値「305」は、合同会社の情報であることを意味する。

15 法人種別

16

17

18

国内所在地
（都道府県）

国内所在地（市区町村）

国内所在地（丁目番地等）kind

prefectureName

cityNamestreetNumber

999

全角文字

全角文字

全角文字

3

10
(最大)

20
(最大)

300
(最大)

○

○

○

○

○

値「399」は、株式会社（301）、有限会社（302）、合名会社（303）、合資会社（304）及び合同会社（305）以外の法令の規定により設立の登記をすることによって成立する法人の情報であることを意味する。

401

外国会社等

値「401」は、外国、外国の行政区画及び外国会社並びに法律又は条約の規定により認許された外国法人の情報であることを意味する。

499

その他

上記以外の人格のない社団等及び日本の法律の規定により成立し、設立の登記を行わない法人の情報であることを意味する。

-

-

-

-

-

-

○

○

○

○

○

○

5

○

○

○

○

○

○

○

○

○

法人番号保有者の本店又は主たる事務所の所在地の都道府県名。
国内所在地の項目（「都道府県」、「市区町村」、「丁目番地等」）について、１項目にまとめた場合、利用者側で「都道府県」、「市区町村」及び「丁目番地等」をそれぞれ別の項目に分割する手間が掛かることから、国内所在地の項目を分割している。
なお、本店又は主たる事務所の所在地が国外にある法人番号保有者は、国内の事務所又は営業所の所在地の都道府県名。
法人番号保有者の本店又は主たる事務所の所在地の市区町村名。
なお、本店又は主たる事務所の所在地が国外にある法人番号保有者は、国内の事務所又は営業所の所在地の市区町村名。
法人番号保有者の本店又は主たる事務所の所在地の丁目番地等。
国内所在地の文字数が、都道府県、市区町村、丁目番地等を合わせて、300
文字を超過した場合、301文字目以降の文字は格納されないため、301文字目
以降の情報は、イメージファイルを閲覧することにより確認することができる。
なお、本店又は主たる事務所の所在地が国外にある法人番号保有者は、国内の事務所又は営業所の所在地の丁目番地等。

リソース定義書（ダウンロードファイル等）
データ形式等

項目名
項番
名称

19

国内所在地
イメージID

形式(凡例参照)

リソース名

addressImageId

99999999

項目値
桁数

8

コード

項目値
名称

○

○

○

○

○

○

○

○

-

21 市区町村コード cityCode

999

3

-

JIS X 0402に準ずる

23 国外所在地

addressOutside

9999999

全角文字

7

300
(最大)

-

-

-

-

○

○

○

○

6

○

ver3 ver4

○

2

○

ver2

○

99

○

項目の説明

Web-API-

20 都道府県コード prefectureCode

postCodeダウン
ロード ver1-

JIS X 0401に準ずる

22 郵便番号

提供項目

○

○

○

○

○

○

○

○

国内所在地イメージIDは、イメージファイルを閲覧するために指定する値（情報）。
当該データ項目は、国内所在地にJIS第１・第２水準以外の文字を使用している場合及び国内所在地の文字数が300文字を超過した場合に値を設定する項目。
なお、当該イメージIDの値を設定したURL※でアクセスすることにより、国税庁
法人番号公表サイトの検索画面で確認できるイメージファイルと同様のイメージ
ファイルを直接閲覧することができる。
※（https://www.houjin-bangou.nta.go.jp/image?imageid=イメージID）
各システムの画面にイメージファイルを表示したいなどの要件がある場合に活用することができる。
データを取り込み、名寄せ作業や不要なデータを識別する際、当該コードを活用することにより、効率的な作業を行うことができる。
都道府県コード及び市区町村コードの詳細については、以下のURL※（日本
産業標準調査会/データベース検索）を参照のこと。
※（https://www.jisc.go.jp/）

国内所在地の文字情報を基に設定した郵便番号。
全国町・字ファイルを基に設定しているため、所在地に外字が含まれる場合
や、誤字脱字がある場合には、正確な郵便番号が設定されていない場合がある。
なお、同一の字・大字内の特定の地番に付される郵便番号や、ビルや大口事
業所に係る個別郵便番号には対応していない。
本店又は主たる事務所の所在地が国外にある法人番号保有者の国外における本店又は主たる事務所の所在地を示すデータ項目。
なお、国外所在地の文字数が300文字を超過した場合、301文字目以降の文字が格納されないため、301文字目以降の情報は、イメージファイルを閲覧する
ことにより確認することができる。

リソース定義書（ダウンロードファイル等）
データ形式等

項目名
項番
名称

形式
(凡例参照)

リソース名

項目値
桁数

コード

項目値
名称

提供項目
ダウン
ロード ver1

項目の説明

Web-APIver2

ver3 ver4

24

国外所在地
イメージID

addressOutside
ImageId

99999999

8

-

-

○

○

○

○

○

25

登記記録の
閉鎖等年月日closeDate

YYYY‐MM‐DD

10

-

-

○

○

○

○

○

-

-

01

清算の結了
等

11

合併による
解散等

21

登記官によ
る閉鎖

31

その他の清
算の結了等

国外所在地イメージIDは、イメージファイルを閲覧するために指定する値（情報）。
当該データ項目は、国外所在地にJIS第１・第２水準以外の文字を使用している場合及び国外所在地の文字数が300文字を超過した場合に値を設定する項目。
なお、当該イメージIDの値を設定したURL※でアクセスすることにより、国税庁
法人番号公表サイトの検索画面で確認できるイメージファイルと同様のイメージ
ファイルを直接閲覧することができる。
※（https://www.houjin-bangou.nta.go.jp/image?imageid=イメージID）
各システムの画面にイメージファイルを表示したいなどの要件がある場合に活用することができる。
登記記録の閉鎖等の事由が生じた年月日を表す。
閉鎖の事由は、登記記録の閉鎖等が生じた事由を表すデータ項目。

登記記録の閉26
鎖等の事由

closeCause992

設立登記法人について、清算の結了等により登記記録が閉鎖された事を意
味する。

○

○

○

○

○

設立登記法人について、合併による解散等により登記記録が閉鎖された事を意味する。
設立登記法人について、商業登記規則第81条により登記記録の閉鎖された事を意味する。
設立登記法人以外について、清算の結了等に類する事由が生じた場合に表
示する。

27

承継先
法人番号

successor
9999999999999
CorporateNumber

13

-

-

○

○

○

○

○

28

変更事由の詳細changeCause

全角半角混在

500
(最大)

-

-

○

○

○

○

○

29

法人番号指定年月日

assignmentDate

YYYY‐MM‐DD

10

-

-

○

○

○

○

○

合併等による事業承継があったことにより登記記録が閉鎖された場合の存続する法人の法人番号。
合併等による事業承継があった場合の事業承継内容を示すデータ項目。
法人番号指定年月日は、法人番号が指定された年月日を表す。

7リソース定義書（ダウンロードファイル等）
データ形式等

項目名項番
名称

30 最新履歴

形式(凡例参照)

リソース名

latest

9

項目値
桁数

1

コード

項目値
名称

-

-

0

過去情報

1

最新情報

提供項目
ダウン
ロード ver1

項目の説明

Web-APIver2

ver3 ver4
応答結果のデータが、最新の情報か過去の情報かを表す。
なお、全件ダウンロードデータについては、月末時点の最新情報を提供することから、値は全て「1」となる。

○

－

○

○

○

値「0」は、過去の情報であることを意味する。
値「1」は、最新の情報であることを意味する。

商号又は名称31（英語表記）

enName

半角英数記号

国内所在地（都
enPrefectureNam
32 道府県）(英語
半角英字
e
表記）

33

34

国内所在地
（市区町村丁目
enCityName
番地等）（英語表記）

半角英数記号

国外所在地（英 enAddressOutsid
半角英数記号語表記）e35 フリガナ

furigana

全角文字

300
(最大)

9
（最大）

600
（最大）

600
（最大）

500
（最大）

-

-

-

-

-

-

-

-

-

-

○

○

○

○

○

－

－

－

－

－

8

○

○

○

○

－

○

○

○

○

○

○

法人番号保有者が登録した商号又は名称（英語表記）。
なお、商号又は名称（英語表記）の文字数の上限は300文字である。
英語表記の登録がない場合はブランクとなる。

○

法人番号保有者が登録した本店又は主たる事務所の所在地の都道府県名（英語表記）。
なお、本店又は主たる事務所の所在地が国外にある法人番号保有者は、国内の事務所又は営業所の所在地の都道府県名（英語表記）。
英語表記の登録がない場合はブランクとなる。

○

法人番号保有者が登録した本店又は主たる事務所の所在地の丁目番地等（英語表記）。
国内所在地（市区町村丁目番地等）（英語表記）の文字数の上限は600文字である。
なお、法人番号保有者が登録した表記を設定しており、市区町村名等の標準化（例えば「XXX-ku」を「XXX ku」へ表現を標準化するなど）の処理は行っていない。
英語表記の登録がない場合はブランクとなる。

○○

本店又は主たる事務所の所在地が国外にある法人番号保有者が登録した国外における本店又は主たる事務所の所在地（英語表記）。
国外所在地（英語表記）の文字数の上限は600文字であり、600文字を超過した場合、601文字目以降の文字は格納されない。
また、格納されている国外所在地（国名等）（英語表記）は、法人番号保有者が登録した表記であり、所在地の表記の統一は行っていない。
英語表記の登録がない場合はブランクとなる。
法人番号保有者の商号又は名称に対するフリガナ情報を示すデータ項目。
フリガナ情報に使用している文字は全角カタカナ及び長音（ー）のみである。
フリガナの登録がない場合はブランクとなる。

リソース定義書（ダウンロードファイル等）
データ形式等

項目名
項番
名称

形式
(凡例参照)

リソース名

項目値
桁数

コード

36 検索対象除外

hihyoji

9

項目値
名称

提供項目
ダウン
ロード ver1

項目の説明

Web-APIver2

ver3 ver4
設立登記法人のうち、登記上の所在地が、住居表示の実施や区画整理等で既に廃止されており、現在では存在しない住所表記となっていることが確認できた法人について、検索対象から除外していることを示すデータ項目。
なお、この情報は法人単位で設定しており、データ提供時点の情報を表してい
る。

-

1

○
0

検索対象

1

検索対象除
外

－

－

－

○

値「0」は、検索対象となっている情報であることを意味する。
値「1」は、検索対象から除外した情報であることを意味する。

9

別紙２

HTTPステータスコード、エラーコード及びエラーメッセージ一覧
HTTP
エラー
ステータス
コード
コード

＜公表サイト＞
対象機能

エラーメッセージ

内容

取得期 法人番 法人名
間指定 号指定 指定

400

010

取得期間開始日が指定されていません。

取得期間開始日が指定されていない場合に設定されます。

○

400

011

取得期間開始日は「YYYY-MM-DD」の形式で指定してください。

取得期間開始日が「YYYY-MM-DD」の形式で指定されていない場合に設定さ
れます。

○

400

012

取得期間開始日について、日付の指定に誤りがあります。存在する日付を指定してください。

取得期間開始日を10桁で指定しているが、存在する日付を指定しない場合に設定されます。

○

400

013

取得期間開始日は2015-12-01以降を指定してください。

取得期間開始日が2015年11月30日以前の場合に設定されます。

○

400

020

取得期間終了日が指定されていません。

取得期間終了日が指定されていない場合に設定されます。

○

400

021

取得期間終了日は「YYYY-MM-DD」の形式で指定してください。

取得期間終了日が「YYYY-MM-DD」の形式で指定されていない場合に設定さ
れます。

○

400

022

取得期間終了日について、日付の指定に誤りがあります。存在する日付を指定してください。

取得期間終了日を10桁で指定しているが、存在する日付を指定しない場合に設定されます。

○

400

030

取得期間開始日は取得期間終了日以前を指定してく取得期間開始日が取得期間終了日後を指定している場合に設定されます。
ださい。

○

400

031

取得期間は指定可能な最大日数の範囲で指定してく 取得期間が指定可能な最大日数（50日）の範囲で指定されていない場合に設ださい。
定されます。

○

400

040

法人番号が指定されていません。

法人番号がリクエスト条件として指定されていない場合に設定されます。

○

400

041

法人番号は10件以内で指定してください。

法人番号が10件以内で指定されていない場合に設定されます。

○

400

042

法人番号は半角数字で指定してください。

法人番号が半角数字で指定されていない場合に設定されます。

○

400

043

法人番号は13桁で指定してください。

法人番号が13桁で指定されていない場合に設定されます。

○

400

050

所在地は半角数字で指定してください。

所在地が半角数字で指定されていない場合に設定されます。

○

○

400

051

所在地は2桁又は5桁で指定してください。

所在地が２桁又は５桁で指定されていない場合に設定されます。

○

○

400

052

所在地の項目値が正しくありません。

JIS X 0401に準ずる都道府県コード又はJIS X 0402に準ずる市区町村コードに存在しないコードを指定した場合に設定されます。

○

○

400

060

法人種別は4件以内で指定してください。

法人種別が４件以内で指定されていない場合に設定されます。

○

○

400

061

法人種別は半角数字で指定してください。

法人種別が半角数字で指定されていない場合に設定されます。

○

○

400

062

法人種別は2桁で指定してください。

法人種別が２桁で指定されていない場合に設定されます。

○

○

400

063

法人種別の項目値が正しくありません。

法人種別の項目値を「国の機関（01）」、「地方公共団体（02）」、「設立登記法人（03）」、「外国会社等・その他（04）」以外の項目値で指定した場合に設定さ
れます。

○

○

400

070

応答形式が指定されていません。

応答形式が指定されていない場合に設定されます。

○

○

○

400

071

応答形式は半角数字で指定してください。

応答形式が半角数字で指定されていない場合に設定されます。

○

○

○

400

072

応答形式は2桁で指定してください。

応答形式が２桁で指定されていない場合に設定されます。

○

○

○

400

073

応答形式の項目値が正しくありません。

応答形式の項目値を「CSV/Shift-JIS(JIS第一及び第二水準)（01）」、「CSV/Unicode(JIS第一～第四水準)（02）」、「XML/Unicode(JIS第一～第四水
準)（12）」以外の項目値で指定した場合に設定されます。

○

○

○

400

080

変更履歴要否は半角数字で指定してください。

変更履歴要否が半角数字で指定されていない場合に設定されます。

○

400

081

変更履歴要否は1桁で指定してください。

変更履歴要否が１桁で指定されていない場合に設定されます。

○

400

082

変更履歴要否の項目値が正しくありません。

変更履歴要否の項目値を「変更履歴なし（0）」、「変更履歴あり（1）」以外の項
目値で指定した場合に設定されます。

○

400

090

分割番号は半角数字で指定してください。

分割番号が半角数字で指定されていない場合に設定されます。

○

○

400

091

分割番号はZZZZ9以下で指定してください。

分割番号が分割数の範囲で指定されていない場合に設定されます。なお、分
割番号及び分割数については、最新の「リソース定義書」を参照してください。

○

○

400

100

商号又は名称が指定されていません。

商号又は名称が指定されていない場合に設定されます。

○

400

101

商号又は名称には（全角文字|半角英数字記号）を
UTF‐8でエンコードして設定してください。

商号又は名称がUTF-8でエンコードされていない場合に設定されます。

○

400

102

商号又は名称には（150文字|300文字）以内で指定してください。

商号又は名称が日本語の場合150文字、英語の場合300文字以内で指定されていない場合に設定されます。

○

400

103

商号又は名称に組織名称（株式会社、有限会社）以
外の文字を指定してください。

商号又は名称に組織名称（株式会社、有限会社）の文字のみを指定している場合に設定されます。

○

別紙２

HTTPステータスコード、エラーコード及びエラーメッセージ一覧
HTTP
エラー
ステータス
コード
コード

＜公表サイト＞
対象機能

エラーメッセージ

内容

取得期 法人番 法人名
間指定 号指定 指定

400

110

商号又は名称検索方式は半角数字で指定してくださ 商号又は名称検索方式が半角数字で指定されていない場合に設定されま
い。
す。

○

400

111

商号又は名称検索方式は1桁で指定してください。

商号又は名称検索方式が１桁で指定されていない場合に設定されます。

○

400

112

商号又は名称検索方式の項目値が正しくありません。

商号又は名称検索方式の項目値を「前方一致検索（1）」、「部分一致検索（0）」以外の項目値で指定した場合に設定されます。

○

400

120

商号又は名称検索対象は半角数字で指定してくださ 商号又は名称検索対象が半角数字で指定されていない場合に設定されま
い。
す。

○

400

121

商号又は名称検索対象は1桁で指定してください。

商号又は名称検索対象が１桁で指定されていない場合に設定されます。

○

400

122

商号又は名称検索対象の項目値が正しくありません。

商号又は名称検索対象の項目値を「商号_検索用（1）」、「商号_1－4水（2）」、「商号_英語表記（3）」以外の項目値で指定した場合に設定されます。

○

400

130

変更履歴は半角数字で指定してください。

変更履歴が半角数字で指定されていない場合に設定されます。

○

400

131

変更履歴は1桁で指定してください。

変更履歴が１桁で指定されていない場合に設定されます。

○

400

132

変更履歴の項目値が正しくありません。

変更履歴の項目値を「含めない（0）」、「含める（1）」以外の項目値で指定した場合に設定されます。

○

400

140

登記記録の閉鎖等は半角数字で指定してください。

登記記録の閉鎖等が半角数字で指定されていない場合に設定されます。

○

400

141

登記記録の閉鎖等は1桁で指定してください。

登記記録の閉鎖等が１桁で指定されていない場合に設定されます。

○

400

142

登記記録の閉鎖等の項目値が正しくありません。

登記記録の閉鎖等の項目値を「含めない（0）」、「含める（1）」以外の項目値で指定した場合に設定されます。

○

400

150

法人番号指定年月日開始日は「YYYY-MM-DD」の形 法人番号指定年月日開始日が「YYYY-MM-DD」の形式で指定されていない場
式で指定してください。
合に設定されます。

○

400

151

法人番号指定年月日開始日について、日付の指定に 法人番号指定年月日開始日を10桁で指定しているが、存在する日付を指定し誤りがあります。存在する日付を指定してください。
ない場合に設定されます。

○

400

152

法人番号指定年月日開始日は2015-10-05以降を指定してください。

法人番号指定年月日開始日が2015年10月４日以前の場合に設定されます。

○

400

160

法人番号指定年月日終了日は「YYYY-MM-DD」の形 法人番号指定年月日終了日が「YYYY-MM-DD」の形式で指定されていない場
式で指定してください。
合に設定されます。

○

400

161

法人番号指定年月日終了日について、日付の指定に 法人番号指定年月日終了日を10桁で指定しているが、存在する日付を指定し誤りがあります。存在する日付を指定してください。
ない場合に設定されます。

○

400

170

法人番号指定年月日開始日は法人番号指定年月日 法人番号指定年月日開始日が法人番号指定年月日終了日後を指定している終了日以前を指定してください。
場合に設定されます。

○

400

180

検索結果件数が多いため結果をお返しできません。
条件を追加するか、又は条件を変更してください。

○

403

-

-

同一アプリケーションＩＤを用い、一定期間内に多数のアクセスをした結果アクセス制限された後に、当該ＩＤを利用しアクセスした場合に設定されます。

○

○

○

404

-

-

指定されたアプリケーションIDが登録されていない又は無効の場合等に設定
されます。

○

○

○

500

-

-

法人番号公表機能に障害等が発生した場合に設定されます。

○

○

○

検索結果件数が多い場合に設定されます。