Skip to main content

法人番号検索API

info

本APIは、プレミアムプランご購読のお客様のみが利用できます。

GET /v1/houjinbangou/:法人番号​

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

リソースURL​

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

パラメーター​

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

レスポンス​

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

{
  "version": "2022-02-22",
  "data": {
    "published_date": "2022-01-31",
    "sequence_number": 1409569,
    "corporate_number": "2021001052596",
    "process": 12,
    "correct": 0,
    "update_date": "2021-01-12",
    "change_date": "2021-01-04",
    "name": "株式会社オープンコレクター",
    "name_image_id": null,
    "kind": 301,
    "address_image_id": null,
    "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_address_line": "",
    "en_address_outside": "",
    "furigana": "オープンコレクター",
    "hihyoji": 0,
    "qualified_invoice_issuer_number": "T2021001052596",
    "address": {
      "postal_code": "1020083",
      "jisx0402": "13101",
      "prefecture": "東京都",
      "prefecture_kana": "",
      "prefecture_roman": "Tokyo",
      "city": "千代田区",
      "city_kana": "",
      "city_roman": "",
      "street_number": "麹町３丁目１２－１４麹町駅前ヒルトップ８階",
      "town": "麹町",
      "kyoto_street": null,
      "block_lot_num": "3-12-14",
      "building": "麹町駅前ヒルトップ",
      "floor_room": "8階"
    }
  }
}

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

名前型説明例
versionstringデータのバージョン番号。YYYY-MM-DD形式のデータ作成日付となっている。"2022-01-31"
dataobject法人番号レコード後述

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

名前型説明例
sequence_numbernumber同一法人番号レコードについての変更履歴番号。数字が大きい方が最新。左にゼロを詰めない数字で、最大桁数8桁で表される。1391194
corporate_numberstring法人番号。国税庁によって法人ごとに付与された、13桁の法人番号"2021001052596"
processnumber処理区分。1:新規、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またはnull商号又は名称イメージID。nameにJIS第１・第２水準以外の文字を使用している、あるいは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
published_datestring国税庁のサイトに記載の更新日。"2021-01-04"
hihyojinumber検索対象除外。設立登記法人のうち、登記上の所在地が、住居表示の実施や区画整理等既に廃止されており、現在では存在しない住所表記となっていることが確認できた法人について、検索対象から除外していることを示すデータ項目。0:検索対象、1:検索対象から除外0
furiganastringnameに対するフリガナ。全角カナ及び長音のみ使用。フリガナの登録がない場合ブランク"オープンコレクター"
en_namestring商号又は名称(英語表記) 半角英数300文字。登録がない場合はブランク"Rumoi Summary Court"
en_address_outsidestringまたはnull国外所在地(英語表記) 半角600文字。601文字以降の文字は格納されない。存在しない場合はnullになる"35 Selegie Road, suiteA-2 Honolulu, Maryland 21401, U.S.A."
en_address_linestringまたはnull国内所在地(市区町村丁目番地等)(英語表記)。半角英数600文字。登録した表記を設定しているため、標準化などの処理は行っていない。存在しない場合はnullになる"4-7, Kashiwagicho, Tomakomai shi"
assignment_datestring法人番号指定年月日。 YYYY-MM-DD。"2015-10-05"
change_causestring変更事由の詳細。全角半角混在500文字。"令和２年５月１日群馬県前橋市大沢三丁目９番地９株式会社○○（2021001052596）に合併し解散"
successor_corporate_numberstringまたはnull承継先法人番号。合併等による事業承継があったときの存続法人の法人番号。存在しない場合はnullになる"2021001052596"
close_causestringまたはnull登記記録の閉鎖等の事由。1:清算の結了等、11:合併による解散等、21:登記官による閉鎖、31:その他の清算の結了等。閉鎖してしない場合はnullになる"21"
close_datestringまたはnull登記記録の閉鎖等年月日。閉鎖していない場合はnullになる"2015-10-05"
address_outside_image_idstringまたはnull国外所在地イメージID。address_outsideにJIS第１・第２水準以外の文字を使用している、あるいは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文字目以降の情報はイメージファイルを閲覧すること。存在しない場合はブランク"アメリカ合衆国ハワイ州２２４１１メリーランド州トライオン・ストリート２０"
qualified_invoice_issuer_numberstringまたはnullインボイス制度登録番号。適格請求書発行事業者として登録された事業者の登録番号。 1"T2021001052596"
address_image_idstringまたはnull国内所在地イメージ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"
addressobject国内所在地を表すサブレコード。

address内のレコードは以下のような構成になっています。

名前型説明例
postal_codestringまたはnull国内所在地の文字情報を基に設定した郵便番号。全国町・字ファイルを基に設定しているため、所在地に外字が含まれる場合や、誤字脱字がある場合には、正確な郵便番号が設定されていない場合がある。なお、同一の字・大字内の特定の地番に付与される郵便番号や、ビルや大口事業所に係る個別郵便番号には対応していない。"1020083"
jisx0402stringまたはnull国内所在地の全国地方公共団体コード"13101"
prefecturestringまたはnull国内所在地の都道府県名"東京都"
prefecture_kanastringまたはnull国内所在地の都道府県名 (読み仮名) 2"トウキョウト"
prefecture_romanstringまたはnull国内所在地の都道府県名 (ローマ字表記)"Tokyo"
citystringまたはnull国内所在地の市区町村および行政区"千代田区"
city_kanastringまたはnull国内所在地の市区町村および行政区 (読み仮名) 2"チヨダク"
city_romanstringまたはnull国内所在地の市区町村および行政区 (ローマ字表記) 2"Chiyoda-ku"
street_numberstring国内所在地の町域以下の住所 (丁目番地等)。都道府県、市区町村との合計文字数300文字を超過した場合は切り捨てられる。301文字目以降の情報はイメージファイルを閲覧すること"麹町３丁目１２－１４麹町駅前ヒルトップ８階"
townstringまたはnullstreet_numberを構成する、国内所在地住所の町名。存在しない場合は空文字あるいはnullになる。"麹町"
kyoto_streetstringまたはnullstreet_numberを構成する、国内所在地住所に含まれる京都の通り名。存在しない場合は空文字あるいはnullになる。"先斗町通四条上る"
block_lot_numstringまたはnullstreet_numberを構成する、国内所在地住所の号番地。存在しない場合は空文字あるいはnullになる。"3-12-14"
buildingstringまたはnullstreet_numberを構成する、国内所在地住所のビル名。存在しない場合は空文字あるいはnullになる。"麹町駅前ヒルトップ"
floor_roomstringまたはnullstreet_numberを構成する、国内所在地住所の階層及び部屋番号。存在しない場合は空文字あるいはnullになる。"8階"
  1. 現在、このフィールドの値が非 null であることは、当該法人が適格請求書発行事業者であることを意味しません。登録の有無については、適格請求書発行事業者APIを利用してご確認ください。↩
  2. 2024年1月現在、技術的制約のため空文字列となります。将来のリリースで提供予定です。↩
  3. 2022年2月リリースで追加された項目。↩