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

改版履歴
項
番
１

版数

作成年月

変更内容

変更理由等

初版

平成 31 年１月

Web-API のデータ項目（検索対―

象除外に係る情報）追加に伴い、新規に作成。
２

1.1 版

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

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

1.2 版

令和３年 10 月

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

―

－

１.
２.

目 次

－

解説書の構成について ........................................... 1
法人番号を指定して情報を取得する機能について.................... 2

2.1. リクエストのフォーマット ............................................... 2
2.1.1. バージョン ........................................................... 2
2.1.2. アプリケーション ID................................................... 2
2.1.3. 条件 ................................................................. 22.2 応答結果 ................................................................ 2
2.3. リクエスト例と応答結果のサンプル ....................................... 2
2.3.1. 変更履歴を含めない場合 ............................................... 2
2.3.2. 変更履歴を含める場合 ................................................. 6３.

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

3.1. リクエストのフォーマット .............................................. 10
3.1.1. バージョン .......................................................... 10
3.1.2. アプリケーション ID.................................................. 10
3.1.3. 条件 ................................................................ 10
3.2 応答結果 ............................................................... 10
3.3. リクエスト例と応答結果のサンプル ...................................... 10４.

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

4.1. リクエストのフォーマット .............................................. 14
4.1.1. バージョン .......................................................... 14
4.1.2. アプリケーション ID.................................................. 14
4.1.3. 条件 ................................................................ 14
4.2 応答結果 ............................................................... 14
4.3. リクエスト例と応答結果のサンプル ...................................... 14

５.
5.1

Ver.4.0 で追加された機能について ............................... 19
Ver.4.0 で追加された機能................................................ 19

5.2 応答結果のサンプル ..................................................... 20

１.

解説書の構成について

Web-API の解説書は、本書を含め、以下のとおり６編で構成しています。
本書では、Web‐API 各機能のリクエストフォーマット、リクエスト例及び応答結果のサンプル（データ）並びに、平成 31 年３月 25 日から、新たに検索対象除外に係る情報のデータ項目を追加したサービス（Ver.4.0）に追加された機能を中心に説明しています。
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. リクエストのフォーマット
法人番号を指定して情報を取得する機能のリクエストのフォーマットは以下のとおりです。四角で囲った「バージョン」、「アプリケーション ID」、
「法人
番号」、
「応答形式」及び「変更履歴要否」にセットする値について説明します。
https://api.houjin-bangou.nta.go.jp/バージョン/num?id=アプリケーショ
ン ID&number=法人番号（１件目）,法人番号（２件目）,…&type=応答形式&変更履歴要否
2.1.1. バージョン「バージョン」には、Web-API のバージョン値「４（半角）」をセットします。
2.1.2. アプリケーション ID「アプリケーション ID」には、アプリケーション ID 発行届出後、国税庁がメールによりお知らせするアプリケーション ID（13 桁）をセットします。
2.1.3. 条件
条件は、｢第二編 Web-API のリクエストの設定方法及び提供データの内容について（概要編）－公表サイト－｣（以下｢第二編｣といいます。）の｢2.1.3.条
件｣をご確認ください。
2.2

応答結果
「応答形式」で設定したファイル形式で、データが応答します。
応答するデータ項目等については、「第二編」の「別紙１ リソース定義書（ダウンロードファイル、Web-API）－公表サイト－」（以下「リソース定義書」といいます。）にて、「提供項目 Web-API(ver4)」欄が「○」の項目をご確認ください。

2.3. リクエスト例と応答結果のサンプル
法人番号を指定して情報を取得する場合のリクエスト例と応答結果のサンプルについて、説明します。
2.3.1. 変更履歴を含めない場合
リクエスト条件に、変更履歴を含めない場合の応答結果のサンプルです。法2

人番号を「5111101000006」と指定した場合を例に説明します。
⑴ ケース１
ファイル形式を CSV、文字コードを Shift-JIS と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/num?id=アプリケーション ID&number=5111101000006&type=01&history=0（リクエスト指定条件）
条件&type=01

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

&history=0

変更履歴を含めない。

（応答結果のサンプル）
データ種類

行番号

応答結果

ヘッダー情報12019-04-05,1,1,1

データ項目

2

1,5111101000006,01,1,2019-04-03,
2015-10-05,"株式会社検索対象除外",,301,"東京都","千代田区","（東京市
神田区小川町一丁目１０番地）",,13,
101,1000000,,,,,,,2015-10-05,1,,,,,,1（応答結果の内容）
応答結果の内容は、「リソース定義書」にて、「提供項目 WebAPI(ver4)」欄が「○」の項目をご確認いただくか、別途提供しているサン
プルデータの解説資料（以下「サンプルデータの説明」といいます。）をご参照ください。

3

⑵ ケース２
ファイル形式を CSV、文字コードを Unicode と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/num?id=アプリケーション ID&number=5111101000006&type=02&history=0（リクエスト指定条件）
条件

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

&type=02&history=0

変更履歴を含めない。

（応答結果のサンプル）
応答結果は、ケース１と同じ値が文字コード（Unicode）で応答します。
（応答結果の内容）
応答結果の内容は、ケース１と同様です。
⑶ ケース３
ファイル形式を XML と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/num?id=アプリケーション ID&number=5111101000006&type=12&history=0（リクエスト指定条件）
条件&type=12&history=0

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

4

（応答結果のサンプル）<?xml version="1.0" encoding="UTF-8"?><corporations><lastUpdateDate>2019-04-05</lastUpdateDate>
ヘッダー情報<count>1</count><divideNumber>1</divideNumber><divideSize>1</divideSize><corporation>
データ項目<sequenceNumber>1</sequenceNumber><corporateNumber>5111101000006</corporateNumber><process>01</process><correct>1</correct><updateDate>2019-04-03</updateDate><changeDate>2015-10-05</changeDate><name>株式会社検索対象除外</name><nameImageId/><kind>301</kind><prefectureName>東京都</prefectureName><cityName>千代田区</cityName><streetNumber>（東京市神田区小川町一丁目１０番地）</streetNumber><addressImageId/><prefectureCode>13</prefectureCode><cityCode>101</cityCode><postCode>1000000</postCode>（中略）<assignmentDate>2015-10-05</assignmentDate><latest>1</latest><enName/><enPrefectureName/><enCityName/><enAddressOutside/><furigana/><hihyoji>1</hihyoji></corporation></corporations>5（応答結果の内容）
イ ヘッダー情報
XML の最上位の構成要素である<corporations>タグの下位要素として、４項目からなるヘッダー情報が応答します。
ロ データ項目
指定した検索条件に該当する法人情報は、<corporation>の下位要素として、各データ項目値が応答します。
データ項目値の内容は、「リソース定義書」にて、「提供項目 WebAPI(ver4)」欄が「○」の項目をご確認いただくか、「サンプルデータの説明」をご参照ください。
2.3.2. 変更履歴を含める場合
リクエストの条件に、変更履歴を含める場合の応答結果のサンプルです。法
人番号を「4111101000007」と指定した場合を例に説明します。
⑴ ケース４
ファイル形式を CSV、文字コードを Shift-JIS と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/num?id=アプリケーション ID&number=4111101000007&type=01&history=1（リクエスト指定条件）
条件

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

&type=01&history=1

変更履歴を含める。

（応答結果のサンプル）
データ種類

行番号

応答結果

ヘッダー情報12019-04-05,2,1,1

データ
項目

2

1,4111101000007,01,1,2019-0403,2015-10-05,"株式会社検索対象除外のち所在地変更により検索対象",,301,"東京都","千代田区","（東京市神田区小川町一丁目２０番地）

データ１

6

データ種類行番号

応答結果",,13,101,1000000,,,,,,,2015-1005,0,,,,,,0

データ 2

3

2,4111101000007,12,1,2019-04-05,
2019-04-04,"株式会社検索対象除外の
ち所在地変更により検索対象",,301,"東京都","千代田区","神田小川町１
丁目２０番地",,13,101,1010052,,,,,,,2015-10-05,1,,,,,,0（応答結果の内容）
イ ヘッダー情報
CSV ファイルの１行目に下表の４項目が応答します。
項目名

データ値

最終更新年月日

2019-04-05

総件数

2

分割番号

1

分割数

1

ロ

データ項目
CSV ファイルの２行目から、リクエストに対応する法人等のデータが応答します。所在地変更に係る履歴情報があるため、履歴の古い順に２件のデータが応答します。
データ項目値の内容は、「リソース定義書」にて、「提供項目 WebAPI(ver4)」欄が「○」の項目をご確認いただくか、「サンプルデータの説明」をご参照ください。

⑵ ケース５
ファイル形式を CSV、文字コードを Unicode と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/num?id=アプリケーション ID&number=4111101000007&type=02&history=1（リクエスト指定条件）
条件&type=02

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

&history=1

変更履歴を含める。

（応答結果のサンプル）
応答結果は、ケース４と同じ値が文字コード（Unicode）で応答します。
（応答結果の内容）
応答結果の内容は、ケース４と同様です。
⑶

ケース６
ファイル形式を XML と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/num?id=アプリケーション ID&number=4111101000007&type=12&history=1（リクエスト指定条件）
条件&type=12&history=1

条件の内容
応答形式は「XML 形式/Unicode(JIS 第一水準から第四水準)」とする。
変更履歴を含める。

8

（応答結果のサンプル）<?xml version="1.0" encoding="UTF-8"?><corporations><lastUpdateDate>2019-04-05</lastUpdateDate>
ヘッダー情報<count>2</count><divideNumber>1</divideNumber><divideSize>1</divideSize><corporation>
データ項目１<sequenceNumber>1</sequenceNumber><corporateNumber>4111101000007</corporateNumber>（中略）<latest>0</latest>（中略）<hihyoji>0</hihyoji></corporation><corporation>
データ項目２<sequenceNumber>2</sequenceNumber><corporateNumber>4111101000007</corporateNumber>（中略）<latest>1</latest>（中略）<hihyoji>0<hihyoji/></corporation></corporations>（応答結果の内容）
イ ヘッダー情報
XML の最上位の構成要素である<corporations>タグの下位要素として、４項目からなるヘッダー情報が応答します。
ロ データ項目
指定した条件に該当する法人情報は、<corporation>の下位要素として、各データ項目値が応答します。
ケース６の場合、該当するデータが２件あるため、<corporation>タグは２回繰り返し応答します。
データ項目値の内容は、ケース４と同様です。

9

３.

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

3.1. リクエストのフォーマット
取得期間を指定して情報を取得する機能のリクエストのフォーマットは以下のとおりです。四角で囲った「バージョン」、「アプリケーション ID」、
「取得
期間開始日」、「取得期間終了日」、「応答形式」及び「条件（１～Ｎ）」にセッ
トする値について説明します。
https://api.houjin-bangou.nta.go.jp/バージョン/diff?id=アプリケーシ
ョン ID&from=取得期間開始日&to=取得期間終了日&type=応答形式&条件１&
条件２…&条件Ｎ
3.1.1. バージョン「バージョン」には、Web-API のバージョン値「４（半角）」をセットします。
3.1.2. アプリケーション ID「アプリケーション ID」には、アプリケーション ID 発行届出後、国税庁がメールによりお知らせするアプリケーション ID（13 桁）をセットします。
3.1.3. 条件
条件は、｢第二編｣の「3.1.3.条件｣をご確認ください。
3.2

応答結果
「応答形式」で設定したファイル形式で、データが応答します。
応答するデータ項目等については、「リソース定義書」にて、｢提供項目 WebAPI(ver4)｣欄が「○」の項目をご確認ください。

3.3. リクエスト例と応答結果のサンプル
平成 31 年４月３日の差分データのみを指定して更新直後に情報を取得する
場合のリクエスト例と応答結果のサンプルについて、説明します。
⑴ ケース７
ファイル形式を CSV、文字コードを Shift-JIS と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/diff?id=アプリケーション ID
10

&from=2019-04-03&to=2019-04-03&type=01（リクエスト指定条件）
条件

条件の内容

&from=2019-04-03&to=2019-04-03

平成 31 年４月３日の更新データを取得する。

&type=01

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

（応答結果のサンプル）
データ種類

行番号

応答結果

ヘッダー情報12019-04-03,2,1,1

データ
項目

データ１

2

1,4111101000007,01,1,2019-04-03,
2015-10-05,"株式会社検索対象除外の
ち所在地変更により検索対象,,301,"東京都","千代田区","（東京市神田区小川町一丁目２０番地）",,13,101,
1000000,,,,,,,2015-10-05,1,,,,,,1

データ 2

3

2,5111101000006,01,1,2019-04-03,
2015-10-05,"株式会社検索対象除外",,301,"東京都","千代田区","（東京市
千代田区小川町一丁目１０番地）",,13,101,1000000,,,,,,,2015-10-05,1,,,,,,1（応答結果の内容）
イ ヘッダー情報
CSV ファイルの１行目に下表の４項目が応答します。
項目名

データ値

最終更新年月日

2019-04-03

総件数

2

分割番号

1

分割数

1

ロ

データ項目
データ項目値の内容は、「リソース定義書」にて、「提供項目 WebAPI(ver4)」欄が「○」の項目をご確認いただくか、「サンプルデータの説明」をご参照ください。
11

⑵ ケース８
ファイル形式を CSV、文字コードを Unicode と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/diff?id=アプリケーション ID&from=2019-04-03&to=2019-04-03&type=02（リクエスト指定条件）
条件

条件の内容

&from=2019-04-03&to=2019-04-03

平成 31 年４月３日の更新データを取得する。

&type=02

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

（応答結果のサンプル）
応答結果は、ケース７と同じ値が文字コード（Unicode）で応答します。
（応答結果の内容）
応答結果の内容は、ケース７と同様です。
⑶ ケース９ファイル形式を XML と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/diff?id=アプリケーション ID&from=2019-04-03&to=2019-04-03&type=12（リクエスト指定条件）
条件

条件の内容

&from=2019-04-03&to=2019-04-03

平成 31 年４月３日の更新データを取得する。

&type=12

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

12

（応答結果のサンプル）<?xml version="1.0" encoding="UTF-8"?><corporations>
ヘッダー情報<lastUpdateDate>2019-04-03</lastUpdateDate><count>2</count><divideNumber>1</divideNumber><divideSize>1</divideSize><corporation>
データ項目１<sequenceNumber>1</sequenceNumber><corporateNumber>4111101000007</corporateNumber>（中略）<furigana/><hihyoji>1</hihyoji></corporation><corporation>
データ項目 2（最終）<sequenceNumber>2</sequenceNumber><corporateNumber>5111101000006</corporateNumber>（中略）<furigana/><hihyoji>1</hihyoji></corporation></corporations>（応答結果の内容）
イ ヘッダー情報
XML の最上位の構成要素である<corporations>タグの下位要素として、４項目からなるヘッダー情報が応答します。
ロ データ項目
指定した条件に該当する法人情報は、<corporation>の下位要素として、各データ項目値が応答します。
ケース９の場合、該当するデータが２件あるため、<corporation>タグは２回繰り返し応答します。
データ項目値の内容は、ケース７と同様です。

13

４.

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

4.1.

リクエストのフォーマット
法人名を指定して情報を取得する機能のリクエストのフォーマットは以下のとおりです。四角で囲った「バージョン」、「アプリケーション ID」、「商号又は名称」、「応答形式」及び「条件（１～Ｎ）」にセットする値について説明します。
https://api.houjin-bangou.nta.go.jp/バージョン/name?id=アプリケーシ
ョン ID&name=商号又は名称&=type=応答形式&条件１&条件２…&条件Ｎ

4.1.1. バージョン「バージョン」には、Web-API のバージョン値「４（半角）」をセットします。
4.1.2. アプリケーション ID「アプリケーション ID」には、アプリケーション ID 発行届出後、国税庁がメールによりお知らせするアプリケーション ID（13 桁）をセットします。
4.1.3. 条件
条件は、｢第二編｣の「4.1.3.条件｣をご確認ください。
4.2

応答結果
「応答形式」で設定したファイル形式で、データが応答します。
応答するデータ項目等については、「リソース定義書」にて、｢提供項目 WebAPI(ver4)｣欄が「○」の項目をご確認ください。

4.3. リクエスト例と応答結果のサンプル
法人名を「国税商事」と指定して情報を取得する場合のリクエスト例と応答
結果のサンプルについて、説明します。
⑴ ケース 10
ファイル形式を CSV、文字コードを Shift-JIS と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/name?id=アプリケーション ID
14

&name=%E5%9B%BD%E7%A8%8E%E5%95%86%E4%BA%8B&change=1&type=01（リクエスト指定条件）
条件

条件の内容

&name=%E5%9B%BD%E7%A8%8E%E5%95%86%E4%BA%8B

法人名を「国税商事」とし、法人名を URL
エンコード（UTF-8）する。

&change=1

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

&type=01（応答結果のサンプル）
データ種類

行番号

応答結果

ヘッダー情報12017-05-10,10,1,1

データ
項目

2

1,2040001999902,01,0,2015-12-01,
2015-10-05,"株式会社国税商事あ",,301,"千葉県","千葉市中央区","中央４丁目５番８号",,12,101,2600013,,,,,,,2015-10-05,1,,,,,,0

データ１

（中
データ 1011略）

10,3040001999901,01,0,2015-12-01,
2015-10-05,"株式会社国税商事Ａ",,
301,"千葉県","千葉市中央区","中央４丁目５番９号",,12,101,2600013,,,,,,,2015-10-05,1,,,,,,0（応答結果の内容）
イ ヘッダー情報
CSV ファイルの１行目に下表の４項目が応答します。
項目名

データ値

最終更新年月日2017-05-10

総件数

10

分割番号

1

分割数

1

ロ

データ項目
CSV ファイルの２行目から、リクエストに対応する法人等のデータが応答します。データ項目値の内容は、「リソース定義書」にて「提供項目15

Web-API(ver4)」欄が「○」の項目をご確認いただくか、「サンプルデー
タの説明」をご参照ください。
⑵ ケース 11
ファイル形式を CSV、文字コードを Unicode と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/name?id=アプリケーション ID&name=%E5%9B%BD%E7%A8%8E%E5%95%86%E4%BA%8B&change=1&type=02（リクエスト指定条件）
条件

条件の内容

&name=%E5%9B%BD%E7%A8%8E%E5%95%86%E4%BA%8B

法人名を「国税商事」とし、法人名を URL
エンコード（UTF-8）する。

&change=1

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

&type=02（応答結果のサンプル）
応答結果は、ケース 10 と同じ値が文字コード(Unicode）で応答します。
（応答結果の内容）
応答結果の内容は、ケース 10 と同様です。
⑶ ケース 12
ファイル形式を XML と指定する場合（リクエスト例）
https://api.houjin-bangou.nta.go.jp/4/name?id=アプリケーション ID&name=%E5%9B%BD%E7%A8%8E%E5%95%86%E4%BA%8B&change=1&type=12（リクエスト指定条件）
条件

条件の内容

&name=%E5%9B%BD%E7%A8%8E%E5%95%86%E4%BA%8B

法人名を「国税商事」とし、法人名を URL
エンコード（UTF-8）する。

&change=1

検索対象に過去の情報を含める。

16

条件&type=12

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

（応答結果のサンプル）<?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>（中略）<enAddressOutside/><furigana/><hihyoji>0</hihyoji></corporation>（中略）
データ項目 10（最終）<corporation><sequenceNumber>10</sequenceNumber><corporateNumber>3040001999901</corporateNumber>（中略）<enAddressOutside/><furigana/><hihyoji>0</hihyoji></corporation></corporations>（応答結果の内容）
イ ヘッダー情報
XML の最上位の構成要素である<corporations>タグの下位要素として、４項目からなるヘッダー情報が応答します。
ロ データ項目
指定した条件に該当する法人情報は、<corporation>の下位要素として、各データ項目値が応答します。
17

ケース 12 の場合、該当するデータが 10 件あるため、<corporation>タ
グは 10 回繰り返し応答します。
データ項目値の内容は、「リソース定義書」にて「提供項目 WebAPI(ver4)」欄が「○」の項目をご確認いただくか、「サンプルデータの説明」をご参照ください。

18

５.

Ver.4.0 で追加された機能について

5.1

Ver.4.0 で追加された機能
Web-API の Ver.4.0 では、Ver.3.0 で取得できる情報に加えて、新たに「検索対象除外に係る情報」のデータ項目（以下｢検索対象除外情報｣という。）を取得することができます。
この章では、取得期間を指定して情報を取得した場合のサンプルデータを基に、当該機能について説明します。（リクエスト例）及び（リクエスト条件）
は省略していますので、リクエスト作成方法については「３. 取得期間を指定
して情報を取得する機能について」(10 ページ)をご確認ください。
なお、「検索対象除外情報」の定義については、「リソース定義書」の項番 36
をご確認ください。
また、検索対象除外法人の定義につきましては、法人番号公表サイトの下記ページをご確認ください。
○ 法人番号公表サイト「検索対象除外法人とは」https://www.houjin-bangou.nta.go.jp/website/riyo-hoho/hihyoji.html（参考）検索対象除外情報の項目値が「１」と応答した法人は、Web-API とは異なり、法人番号公表サイトの検索条件のデフォルト値では、検索結果に表示されません。

19

5.2 応答結果のサンプル⑴ ケース 13平成 31 年４月３日の差分データのみ指定し、更新直後に取得する場合（ケース７と同じ）（CSV 形式/Shift-JIS(JIS 第一・第二水準)での応答結果のサンプル）
データ種類

行番号

応答結果

ヘッダー情報12019-04-03,2,1,1

データ
項目

データ１

2

1,4111101000007,01,1,2019-04-03,
2015-10-05,"株式会社検索対象除外の
ち所在地変更により検索対象",,301,"東京都","千代田区","（東京市神田区小川町一丁目２０番地）",,13,101,
1000000,,,,,,,2015-10-05,1,,,,,,1

データ 2

3

2,5111101000006,01,1,2019-04-03,
2015-10-05,"株式会社検索対象除外",,301,"東京都","千代田区","（東京市
神田区小川町一丁目１０番地）",,13,
101,1000000,,,,,,,2015-10-05,1,,,,,,1（応答結果の内容）
CSV ファイルの１行目にヘッダー情報、２行目からリクエストに対応する法人等のデータが応答します。データ項目値の内容は、「リソース定義書」にて、「提供項目 Web-API(ver4)」欄が「○」の項目をご確認いただ
くか、「サンプルデータの説明」をご参照ください。
上記応答結果から、法人番号「4111101000007」及び「5111101000006」の２法人について、平成 31 年４月３日に訂正区分「１」のデータが更新され、リクエスト送信時点の検索対象除外情報が「１」であることが分かり
ます。

20

⑵

ケース 14
平成 31 年４月４日の差分データのみ指定し、更新直後に取得する場合（CSV 形式/Shift-JIS(JIS 第一・第二水準)での応答結果のサンプル）
データ種類

行番号

応答結果

ヘッダー情報12019-04-04,1,1,1

データ
項目

2

1,4111101000007,12,0,2019-04-04,
2019-04-04,"株式会社検索対象除外の
ち所在地変更により検索対象",,301,"東京都","千代田区","神田小川町１
丁目２０番地",,13,101,1010052,,,,,,,2015-10-05,1,,,,,,1

データ１（応答結果の内容）
CSV ファイルの１行目にヘッダー情報、２行目からリクエストに対応する法人等のデータが応答します。データ項目値の内容は、「リソース定義書」にて、「提供項目 Web-API(ver4)」欄が「○」の項目をご確認いただ
くか、「サンプルデータの説明」をご参照ください。
上記応答結果から、法人番号「4111101000007」の法人について、平成31 年４月４日に処理区分「12」(国内所在地の変更)のデータが更新されたが、リクエスト送信時点の検索対象除外情報は依然「１」であることが分かります。
⑶

ケース 15平成 31 年４月５日の差分データのみ指定し、更新直後に取得する場合（CSV 形式/Shift-JIS(JIS 第一・第二水準)での応答結果のサンプル）
データ種類

行番号

応答結果

ヘッダー情報12019-04-05,2,1,1

データ
項目

データ１

2

1,4111101000007,01,1,2019-04-05,
2015-10-05,"株式会社検索対象除外の
ち所在地変更により検索対象",,301,"東京都","千代田区","（東京市神田区小川町一丁目２０番地）",,13,101,
1000000,,,,,,,2015-10-05,0,,,,,,0

データ 2

3

2,4111101000007,12,1,2019-04-05,21データ種類行番号

応答結果2019-04-04,"株式会社検索対象除外の
ち所在地変更により検索対象",,301,"東京都","千代田区","神田小川町１
丁目２０番地",,13,101,1010052,,,,,,,2015-10-05,1,,,,,,0（応答結果の内容）
CSV ファイルの１行目にヘッダー情報、２行目からリクエストに対応する法人等のデータが応答します。データ項目値の内容は、「リソース定義書」にて、「提供項目 Web-API(ver4)」欄が「○」の項目をご確認いただ
くか、「サンプルデータの説明」をご参照ください。
上記応答結果からは、法人番号「4111101000007」の法人について、平成31 年４月５日に訂正区分「１」のデータが更新され、リクエスト送信時点の検索対象除外情報が「０」であることが分かります。
検索対象除外情報を更新する場合、履歴情報も含めた全データを最新の検索対象除外情報に更新します。上記応答結果では、検索対象除外情報を更新した法人に、履歴情報（国内所在地変更前のデータ）が１件存在したため、履歴情報も含めた２件のデータが応答します。

22

別紙１

リソース定義書（ダウンロードファイル、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）。
・データベースが更新される日時を変更（項番２）。

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

全体

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

項番

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-API
ver2
○

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-API
ver2

ver3

ver4

7 一連番号

sequenceNumber ZZZZZZZ9

1～8

-

-

○

○

○

○

○

8 法人番号

corporateNumber 9999999999999

13

-

-

○

○

○

○

○

-

9 処理区分process

99

新規

11

商号又は
名称の変更

12

国内所在地
の変更

13

国外所在地
の変更

21

登記記録
の閉鎖等

22

登記記録
の復活等

2

法人番号の指定を受けた者（以下「法人番号保有者」という。）の法人番号を示すデータ項目。
法人番号の指定、商号又は所在地に変更等が発生した事由をコード値で表す項目。
※英語表記及びフリガナの登録並びに検索対象除外の情報の更新に係る処理区分はありません（これらの項目は、提供済みのデータに英語表記若しくはフリガナの登録又は検索対象除外の情報を追加した上で、訂正データとして提供す
るため）。

-

01

全件データ（月末時点の最新情報）やWeb-APIによる法人番号を指定した最新情報の取得以外の場合（例えば、ある法人の情報を履歴情報を含めて取得する場合や、日次の更新情報を取得する場合。）には、同一法人に関する情報が複数存在することがある。
その際に、法人（法人番号）単位に時系列の更新処理等を行う場合、一連番号が小さい値の情報から順番に処理することにより、時系列に順序性を保って更新処理を行うことを可能とするための項目。
なお、ダウンロードでは、１ファイルのファイルサイズが過度に大きくなる場合にファイルが分割して提供され、Web-APIではデータ件数が2,000件を超過した
場合にデータが分割して提供されるが、いずれの場合も、一連番号は、データ全体を通じて付される。

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

○

○

○

○

○

値「12」は、国内における本店又は主たる事務所の所在地の変更、国内に本店又は主たる事務所がない法人等の場合は、国内における事務所又は営業所の所在地の変更又は、市区町村合併等により住居表示が変更されたことを表す情報であることを意味する。
値「13」は、国外における本店又は主たる事務所の所在地が変更されたことを表す情報であることを意味する。
値「21」は、清算の結了、合併による解散などの事由により登記記録の閉鎖等の事由が生じたことを表す情報であることを意味する。
値「22」は、清算の結了、合併による解散などの事由により登記記録の閉鎖等が生じた後、清算結了等の手続に瑕疵があり、清算結了が無効になるなどの事由により登記記録が復活等したことを表す情報であることを意味する。

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

項目名
項番
名称

9 処理区分

形式(凡例参照)

リソース名

process

99

項目値
桁数

2

コード

項目値
名称

71

吸収合併

72

吸収合併無
効

81

商号の登記
の抹消

99

提供項目
ダウン
ロード ver1

項目の説明

Web-API
ver2

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-API
ver2

ver3

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

12 変更年月日

13 商号又は名称

14changeDate

name

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

YYYY‐MM‐DD

全角文字

99999999

10

150
(最大)

8

-

-

-

-

15 法人種別

kind

999

-

-

-

国の機関

201

地方公共
団体

301

○

○

○

○

○

○

○

○

○

○

○

○

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

○

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

○

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

-

101

3

○

値「101」は、行政機関、裁判所及び国会の機関に係る情報であることを意味する。
値「201」は、地方自治法第１条の３において定義されている普通地方公共団
体及び特別地方公共団体に係る情報であることを意味する。
○

○

株式会社

4

○

○

○

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

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

項目名
項番
名称

形式
(凡例参照)

リソース名

項目値
桁数

コード

項目値
名称

302

有限会社

303

合名会社

304

合資会社

305

合同会社

399

その他の
設立登記法
人

提供項目
ダウン
ロード ver1

項目の説明

Web-API
ver2

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

○

○

○

ver4

○

-

○

ver3

○

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-API
ver2

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

項目値
名称

提供項目
ダウン
ロード ver1

項目の説明

Web-API
ver2

ver3

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

-

0

過去情報

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-API
ver2

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

-

-

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

○

○

○

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