Skip to main content

法人番号API

info

本APIは、法人番号プランご購読のお客様のみが利用できます。

法人番号APIは、法人番号データ内に存在する法人情報のデータを返すためのAPIです。

GET /houjinbangou/:法人番号#

指定された法人番号に対応する最新の法人情報リソースを取得します。

リソースURL#

https://api.kenall.jp/v1/houjinbangou/:法人番号

パラメータ#

名前必須かどうか説明
法人番号string必須国税庁によって法人ごとに付与された、13桁の法人番号https://api.kenall.jp/v1/houjinbangou/2021001052596

レスポンス#

以下は法人番号データのレスポンスの一例です。

{  "version": "2021-08-20",  "data": {    "published_date": "2021-07-30",    "sequence_number": "1391194",    "corporate_number": "2021001052596",    "process": "12",    "correct": "0",    "update_date": "2021-01-12",    "change_date": "2021-01-04",    "name": "株式会社オープンコレクター",    "name_image_id": null,    "kind": "301",    "prefecture_name": "東京都",    "city_name": "千代田区",    "street_number": "麹町3丁目12-14麹町駅前ヒルトップ8階",    "address_image_id": null,    "jisx0402": "13101",    "post_code": "1020083",    "address_outside": "",    "address_outside_image_id": null,    "close_date": null,    "close_cause": null,    "successor_corporate_number": null,    "change_cause": "",    "assignment_date": "2015-10-05",    "en_name": "",    "en_prefecture_name": "Tokyo",    "en_address_line": "",    "en_address_outside": "",    "furigana": "オープンコレクター",    "hihyoji": "0"  }}

レスポンスのデータは以下のような構成になっています。

名前説明
versionstringデータのバージョン番号。YYYY-MM-DD形式の、データ作成日付となっている。
datamap法人番号レコード

data内の法人番号レコードは以下のような構成になっています。

名前説明
sequence_numbernumber同一法人番号レコードについての変更履歴番号。数字が大きい方が最新。左にゼロを詰めない数字で、最大桁数8桁で表される。1391194
corporate_numberstring法人番号。国税庁によって法人ごとに付与された、13桁の法人番号2021001052596
processnumber処理区分。01:新規、11:商号又は名称の変更、12:国内所在地の変更、13:国外所在地の変更、21:登記記録の閉鎖等、22:登記記録の復活等、71:吸収合併、72:吸収合併無効、81:商号の登記抹消、99:削除12
correctnumber訂正区分。 0:訂正以外、1:訂正0
update_datestring更新年月日。 YYYY-MM-DD。2021-01-12
change_datestring変更年月日。処理区分01の場合、法人番号が指定された年月日。01以外の場合で、設立登記法人のときは、処理区分の事由に係る登記年月日。設立登記法人以外ののときは、処理区分の事由が生じた年月日。2021-01-04
namestring商号又は名称。全角。150文字を超過した場合は切り捨てられる。全情報を確認するにはイメージファイルを閲覧すること株式会社オープンコレクター
name_image_idstring商号又は名称イメージID。nameにJIS第1・第2水準以外の文字を使用している、あるいはnameの文字が150文字を超えた場合に値が設定される。次のURLからイメージファイルを直接確認できる。 https://www.houjin-bangou.nta.go.jp/image?imageid=name_image_id URLに指定するときは左にゼロを詰めて数字8桁にする必要がある。左にゼロを詰めない数字で、最大桁数8桁で現される。存在しない場合はnullになる99999999
kindnumber法人番号種別。101:国の機関、201:地方公共団体、301:株式会社、302:有限会社、303:合名会社、304:合資会社、305:合同会社、399:その他の設立登記法人、401:外国会社等、499:その他301
prefecture_namestring国内所在地(都道府県)東京都
city_namestring国内所在地(市区町村)千代田区
published_datestring国税庁のサイトに記載の更新日。2021-01-04
hihyojinumber検索対象除外。設立登記法人のうち、登記上の所在地が、住居表示の実施や区画整理等既に廃止されており、現在では存在しない住所表記となっていることが確認できた法人について、検索対象から除外していることを示すデータ項目。0:検索対象、1:検索対象から除外0
furiganastringnameに対するフリガナ。全角カナ及び長音のみ使用。フリガナの登録がない場合ブランクオープンコレクター
en_address_outsidestring国外所在地(英語表記) 半角600文字。601文字以降の文字は格納されない。存在しない場合はnullになる35 Selegie Road, suiteA-2 Honolulu, Maryland 21401, U.S.A.
en_address_linestring国内所在地(市区町村丁目番地等)(英語表記)。半角英数600文字。登録した表記を設定しているため、標準化などの処理は行っていない。存在しない場合はnullになる4-7, Kashiwagicho, Tomakomai shi
en_prefecture_namestring国内所在地(都道府県)(英語表記)Tokyo
en_namestring商号又は名称(英語表記) 半角英数300文字。登録がない場合はブランクRumoi Summary Court
assignment_datestring法人番号指定年月日。 YYYY-MM-DD。2015-10-05
change_causestring変更事由の詳細。全角半角混在500文字。令和2年5月1日群馬県前橋市大沢三丁目9番地9株式会社○○(2021001052596)に合併し解散
successor_corporate_numberstring承継先法人番号。合併等による事業承継があったときの存続法人の法人番号。存在しない場合はnullになる2021001052596
close_causestring登記記録の閉鎖等の事由。01:精算の結了等、11:合併による解散等、21:登記官による閉鎖、31:その他の精算の結了等。閉鎖してしない場合はnullになる21
close_datestring登記記録の閉鎖等年月日。閉鎖していない場合はnullになる2015-10-05
address_outside_image_idstring国外所在地イメージID。address_outsideにJIS第1・第2水準以外の文字を使用している、あるいはaddress_outsideの文字が300文字を超えた場合に値が設定される。以下のURLからイメージファイルを直接確認できる。https://www.houjin-bangou.nta.go.jp/image?imageid=address_outside_image_id URLに指定するときは左にゼロを詰めて数字8桁にする必要がある。左にゼロを詰めない数字で、最大桁数8桁で現される。存在しない場合はnullになる99999999
address_outsidestring国外所在地。全角300文字。300文字を超過した場合は切り捨てられる。301文字目以降の情報はイメージファイルを閲覧すること。存在しない場合はブランクアメリカ合衆国ハワイ州22411メリーランド州トライオン・ストリート20
post_codestring国内所在地の文字情報を基に設定した郵便番号。全国町・字ファイルを基に設定しているため、所在地に外字が含まれる場合や、誤字脱字がある場合には、正確な郵便番号が設定されていない場合がある。なお、同一の字・大字内の特定の地番に付与される郵便番号や、ビルや大口事業所に係る個別郵便番号には対応していない。1020083
jisx0402string全国地方公共団体コード13101
address_image_idstring国内所在地イメージID。street_numberにJIS第1・第2水準以外の文字を使用している、あるいはstreet_numberの文字が300文字を超えた場合に値が設定される。以下のURLからイメージファイルを直接確認できる。https://www.houjin-bangou.nta.go.jp/image?imageid=address_image_id URLに指定するときは左にゼロを詰めて数字8桁にする必要がある。左にゼロを詰めない数字で、最大桁数8桁で現される。存在しない場合はnullになる99999999
street_numberstring国内所在地(丁目番地等)。都道府県、市区町村との合計文字数300文字を超過した場合は切り捨てられる。301文字目以降の情報はイメージファイルを閲覧すること麹町3丁目12-14麹町駅前ヒルトップ8階

GET /houjinbangou?q=...&offset=...&limit=...&mode=...&facet_area=...&facet_kind=...&facet_process=...&facet_close_cause=...#

与えられた検索クエリを元に、該当する法人情報リソースを取得します。

リソースURL#

https://api.kenall.jp/v1/houjinbangou

パラメータ#

名前必須かどうか説明
qstring必須検索クエリ。クエリの仕様については検索クエリの仕様を参照のこと。株式会社オープンコレクター
offsetnumber省略可結果を取得するオフセット値。省略した場合は0と見なされる。0
limitnumber省略可最大取得件数を指定する。1以上100以下の値を指定できる。50
modestring省略可法人名の検索モードの変更。部分一致検索(partial)、完全一致検索(法人種別込み)(exact_with_kind)、完全一致検索(法人種別抜き)(exact)かを指定する。デフォルトはpartial。法人名以外は常に部分一致。詳細は検索モードを参照exact
facet_areastring省略可地域ファセットの階層を指定する。詳細はファセットを参照/東京都
facet_kindstring省略可法人種別ファセットの階層を指定する。詳細はファセットを参照/株式会社
facet_processstring省略可処理区分ファセットの階層を指定する。詳細はファセットを参照/新規
facet_close_causestring省略可閉鎖事由ファセットの階層を指定する。詳細はファセットを参照/精算の結了等

検索クエリの仕様#

  • デフォルトは部分一致検索です。法人名の検索については、検索モードの変更によって、完全一致(法人種別込み)と完全一致(法人種別抜き)の変更が可能です。詳細は検索モードを参照してください。

    • 法人名以外のフィールドは常に部分一致検索のみ行います。
  • 検索ワードは一つ以上の半角スペース、タブまたは改行文字で区切ります。

  • 検索ワードの間に AND もしくは OR といったキーワード文字列を挟むと、「かつ」「もしくは」といった条件で検索が可能です。キーワード文字列がない場合は「もしくは」となります。

    • (例1) オープン AND コレクター → 「オープン」「コレクター」の両方を含むレコードを検索する。
    • (例2) オープン OR コレクター → 「オープン」もしくは「コレクター」 (またはその両方) を含むレコードを検索する。
    • (例3) オープン コレクター → 「オープン」もしくは「コレクター」 (またはその両方) を含むレコードを検索する。
  • 特定の項目のみを対象に検索を行いたいときは、項目名に続けて : (半角コロン) を記述し、その後にキーワード文字列を記載します。

    • (例) 法人名に「オープンコレクター」を含む法人情報を取得する → name:オープンコレクター
  • キーワード文字列は正規化されます。詳細は検索の正規化を参照してください。

    • 全角・半角どちらでも入力可能
      • (例) オープンコレクター (半角カナ) → オープンコレクターを検索する。
    • かな小文字・大文字どちらでも入力可能
      • (例) キヨウトフキョウトフキヨウトフのどちらかを含むレコードを検索する。
    • 歴史的仮名遣い・現代仮名遣いどちらでも入力可能
      • (例) ゐろはにほへとゐろはにほへといろはにほへとのどちらかを含むレコードを検索する。
    • 旧字体・異体字・新字体いずれでも入力可能。詳細は旧字体・非標準文字の正規化を参照してください。
      • (例) 株式會社オープンコレクター株式会社オープンコレクターを検索する。
  • 特定のファセットの階層以下の情報を取得したい場合は下記のクエリを使用します。詳細はファセットを参照してください。

    • (例1)_facet_area:/宮城県
    • (例2)_facet_kind:/株式会社

検索対象フィールド#

検索クエリで指定できるフィールドは以下の通りです。

検索項目説明
namestring商号又は名称。150文字を超過した場合は切り捨てられている株式会社オープンコレクター
en_namestring商号又は名称(英語表記) 半角英数300文字。登録がない場合はブランク
furiganastringnameに対するフリガナ。全角カナ及び長音のみ使用。フリガナの登録がない場合ブランクオープンコレクター
post_codestring国内所在地の文字情報を基に設定した郵便番号。全国町・字ファイルを基に設定しているため、所在地に外字が含まれる場合や、誤字脱字がある場合には、正確な郵便番号が設定されていない場合がある。なお、同一の字・大字内の特定の地番に付与される郵便番号や、ビルや大口事業所に係る個別郵便番号には対応していない。1020083
prefecture_namestring国内所在地(都道府県)東京都
city_namestring国内所在地(市区町村)千代田区
address_outsidestring国外所在地。全角300文字。300文字を超過した場合は切り捨てられる。301文字目以降の情報はイメージファイルを閲覧すること。
street_numberstring国内所在地(丁目番地等)。都道府県、市区町村との合計文字数300文字を超過した場合は切り捨てられる。麹町3丁目12-14麹町駅前ヒルトップ8階
_facet_areastring省略可地域ファセットの階層を指定する。詳細はファセットを参照
_facet_kindstring省略可法人種別ファセットの階層を指定する。詳細はファセットを参照
_facet_processstring省略可処理区分ファセットの階層を指定する。詳細はファセットを参照
_facet_close_causestring省略可閉鎖事由ファセットの階層を指定する。詳細はファセットを参照

検索モード#

法人名の検索モードは、デフォルトの部分一致の他、完全一致(法人種別込み)と完全一致(法人種別抜き)の3つのモードを提供しています。

  • (例1) デフォルト(部分一致)を用いてオープンコレクターで検索すると、以下のレコードがヒット

    • 株式会社○○オープンコレクター
    • 株式会社オープンコレクター○○
    • オープンコレクター株式会社
    • 株式会社オープンコレクター
  • (例2) 完全一致(法人種別抜き)(mode=exact)を用いてオープンコレクターで検索すると、以下のレコードがヒット

    • オープンコレクター株式会社
    • 株式会社オープンコレクター
  • (例3) デフォルト(部分一致)を用いて株式会社オープンコレクターで検索すると、以下のレコードがヒット

    • 株式会社オープンコレクター○○
    • 株式会社オープンコレクター
  • (例4) 完全一致(法人種別込み)(mode=exact_with_kind)を用いて株式会社オープンコレクターで検索すると、以下のレコードがヒット

    • 株式会社オープンコレクター
  • 部分一致モードで検索する場合、検索文字列は2文字以上必要です。1文字で検索すると完全一致の法人名のみが検索されます。

    • (例5) 部分一致モードでname:(漢字1文字)を検索 → 何も検索にヒットしない
    • (例6) 完全一致モード(法人種別抜き)でname:(漢字1文字)を検索 → 株式会社(漢字1文字)などがヒット
    • (例7) 部分一致モードで(漢字1文字)を検索 → 株式会社(漢字1文字)などがヒット(完全一致モードの検索結果と同じ)
  • 完全一致(法人種別抜き)で省略可能な法人種別については、完全一致(法人種別抜き)の省略可能な法人種別を参照してください。

完全一致(法人種別抜き)の省略可能な法人種別#

完全一致(法人種別抜き)で省略可能な法人種別は以下の通りです。

  • 株式会社
  • 有限会社
  • 合資会社
  • 合同会社
  • 合名会社
  • 相互会社
  • 医療法人
  • 医療法人財団
  • 医療法人社団
  • 社会医療法人
  • 社会福祉法人
  • 財団法人
  • 社団法人
  • 一般財団法人
  • 一般社団法人
  • 公益財団法人
  • 公益社団法人
  • 学校法人
  • 国立大学法人
  • 公立大学法人
  • 更生保護法人
  • 独立行政法人
  • 地方独立行政法人
  • 農業生産法人
  • 農事組合法人
  • 弁護士法人
  • 税理士法人
  • 行政書士法人
  • 司法書士法人
  • 社会保険労務士法人
  • 管理組合法人
  • 無限責任中間法人
  • 有限責任中間法人
  • 宗教法人
  • 特定非営利活動法人
  • 協同組合
  • 生活協同組合
  • 漁業協同組合
  • 労働組合
  • 従業員組合
  • 連合会
  • 厚生年金基金

検索の正規化#

法人番号APIは、検索時のキーワードを正規化します。これにより、ユーザーは入力文字列のフォーマットを整理する必要なく、必要なレコードを簡単に取得することができるようになります。

正規化対象フィールド#

正規化されるフィールドは以下の通りです。

  • name
  • en_name
  • furigana
  • address_outside
  • street_number

正規化ルール#

en_name以外の正規化対象フィールドは以下のルールで正規化されます。

  • 全角・半角の正規化: 検索時には全角・半角を区別しません。
  • 旧字体・非標準文字の正規化: 旧字体や非標準文字の検索時には、新字体と漢字を区別しません。詳しくは旧字体・非標準文字の正規化も参照してください。
  • かな小文字の正規化: 拗音()、促音()、ぁぃぅぇぉの検索時には大文字・小文字を区別しません。ただし、完全一致検索の場合は正規化を行いません。
  • 歴史的仮名遣いの正規化: の検索時にはそれぞれと区別しません。ただし、完全一致検索の場合は正規化を行いません。

en_nameは以下のルールで正規化されます。

  • 全角・半角の正規化: 検索時には全角・半角を区別しません。

旧字体・非標準文字の正規化#

法人番号APIは、旧字体や非標準文字による検索に対応しています。例えば、非JIS漢字である(はしご高)で検索した場合、常用漢字のを検索します。そのため、法人番号データに含まれていない登記簿上の法人名でそのまま検索することができます。

  • (例1) 髙橋高橋を含むレコードを検索する。(はしご高は非JIS漢字のため法人番号データには未収録)
  • (例2) 計畫計画あるいは計畫を含むレコードを検索する。

一部未対応の漢字もあります。制限事項も参照してください。

ファセット#

ファセットのパス名は必ず / で始まり、各階層は / で区切られます。ルート階層は /で表されます。

ファセットには以下の4種類があります。

  • 地域ファセット(facet_area): 都道府県や市区町村を表すファセット。 (例) /東京都/千代田区
  • 法人種別ファセット(facet_kind): 法人種別を表すファセット。 (例) /株式会社
  • 処理区分ファセット(facet_process): 処理区分を表すファセット。 (例) /新規
  • 閉鎖事由ファセット(facet_close_cause): 閉鎖事由を表すファセット。 (例) /精算の結了等

入力できる項目は以下の通りです。

  • 地域ファセット(facet_area)
    • /{都道府県}
    • /{都道府県}/{市区町村}
    • /海外など
      • 国外の法人を対象とする場合はこのファセットを指定してください。
  • 法人種別ファセット(facet_kind)
    • 行政機関など
    • 地方公共団体
    • 株式会社
    • 有限会社
    • 合名会社
    • 合資会社
    • 合同会社
    • その他の設立登記法人
    • 外国会社等
    • その他
  • 処理区分ファセット(facet_process)
    • 新規
    • 商号又は名称の変更
    • 国内所在地の変更
    • 国外所在地の変更
    • 登記記録の閉鎖等
    • 登記記録の復活等
    • 吸収合併
    • 吸収合併無効
    • 商号の登記の抹消
    • 削除
  • 閉鎖事由ファセット(facet_close_cause)
    • 清算の結了等
    • 合併による解散等
    • 登記官による閉鎖
    • その他の清算の結了等

クエリの実行例#

  • 法人名: 株式会社オープンコレクターを検索
    • https://api.kenall.jp/v1/houjinbangou?q=株式会社オープンコレクター
  • 法人名にオープンコレクターを含み、かつ都道府県が東京都の法人を1件だけ検索
    • https://api.kenall.jp/v1/houjinbangou?q=name:オープンコレクター AND prefecture_name:東京都&limit=1
  • 法人種別が株式会社で、かつ法人名にオープンコレクターを含む法人を検索
    • https://api.kenall.jp/v1/houjinbangou?q=name:オープンコレクター&facet_kind=/株式会社

レスポンス#

{  "version": "2021-08-20",  "data": [    {      "published_date": "2021-07-30",      "sequence_number": "1391194",      "corporate_number": "2021001052596",      "process": "12",      "correct": "0",      "update_date": "2021-01-12",      "change_date": "2021-01-04",      "name": "株式会社オープンコレクター",      "name_image_id": null,      "kind": "301",      "prefecture_name": "東京都",      "city_name": "千代田区",      "street_number": "麹町3丁目12-14麹町駅前ヒルトップ8階",      "address_image_id": null,      "jisx0402": "13101",      "post_code": "1020083",      "address_outside": "",      "address_outside_image_id": null,      "close_date": null,      "close_cause": null,      "successor_corporate_number": null,      "change_cause": "",      "assignment_date": "2015-10-05",      "en_name": "",      "en_prefecture_name": "Tokyo",      "en_address_line": "",      "en_address_outside": "",      "furigana": "オープンコレクター",      "hihyoji": "0"    }  ],  "query": "name:オープンコレクター",  "count": 3,  "offset": 0,  "limit": 100,  "facets": {    "area": [      ["/大阪府", 2],      ["/東京都", 1]    ],    "kind": [      ["/合同会社", 1],      ["/有限会社", 1],      ["/株式会社", 1]    ],    "process": [      ["/吸収合併", 1],      ["/国内所在地の変更", 1],      ["/新規", 1]    ],    "close_cause": [      ["/その他", 2],      ["/合併による解散等", 1]    ]  }}

レスポンスのデータは以下のような構成になっています。

名前説明
versionstringデータのバージョン番号。YYYY-MM-DD形式の、データ作成日付となっている。
dataarray法人番号レコードの配列
querystringq パラメータに与えられたクエリ文字列name:オープンコレクター
countnumberクエリに合致したレコードの総数 (dataプロパティに返却されるレコードの数ではなく、合致したすべてのレコードの件数)1
offsetnumberoffsetパラメータに与えられたオフセット0
limitnumberlimitパラメータに与えられた最大取得件数100
facetsmapファセットパラメータが与えられた場合のみ出力される。パラメータで示されたファセット階層配下のファセットとそのファセットに含まれるレコードの数のペアの配列。後述

data内のそれぞれの法人番号レコードは法人番号検索APIのレスポンスと同一です。

法人番号検索APIと異なり、レスポンスが配列になっていることにご注意ください。

facets内のデータは以下のような構成になっています。

名前説明
areaarray地域ファセットの結果["/東京都": 1]
kindarray法人種別ファセットの結果["/株式会社": 1]
processarray処理ファセットの結果["/国内所在地の変更": 1]
close_causearray閉鎖事由ファセットの結果["/その他": 1]