法人番号API リファレンス

エンドポイント一覧この見出しへのリンク

共通仕様この見出しへのリンク

**① 法人番号検索 (Forward Lookup) **

GET /v1/houjinbangou/{法人番号}この見出しへのリンク

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

リソースURLこの見出しへのリンク

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

パラメータこの見出しへのリンク

クエリパラメータはありません。

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.kenall.jp/v1/houjinbangou/2021001052596

レスポンス例この見出しへのリンク

このAPIはバージョン間で構造変更あり。2024-01-01 版では address がオブジェクト、2022-09-01 版ではフラット (個別フィールド) です。

{
  "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階"
    }
  }
}

{
  "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階"
    }
  }
}

{
  "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",
    "prefecture_name": "東京都",
    "city_name": "千代田区",
    "street_number": "麹町３丁目１２－１４麹町駅前ヒルトップ８階",
    "town": "麹町",
    "kyoto_street": null,
    "block_lot_num": "3-12-14",
    "building": "麹町駅前ヒルトップ",
    "floor_room": "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"
  }
}

レスポンス・トップレベルフィールドこの見出しへのリンク

data オブジェクトのフィールド仕様この見出しへのリンク

識別子・メタ情報この見出しへのリンク

名称・フリガナこの見出しへのリンク

法人種別この見出しへのリンク

処理区分・訂正区分この見出しへのリンク

住所この見出しへのリンク

閉鎖・承継この見出しへのリンク

その他この見出しへのリンク

data.address オブジェクトのフィールド仕様この見出しへのリンク

注意事項 (法人番号検索)この見出しへのリンク

• 文字数制限とイメージID: name(150文字)、street_number(300文字)、address_outside(300文字) を超過した場合、それぞれ name_image_id / address_image_id / address_outside_image_id にイメージファイルIDが設定されます。イメージ画像は https://www.houjin-bangou.nta.go.jp/image?imageid=<イメージID> から直接確認できます (IDは左にゼロを詰めた数字8桁で指定します)
• 郵便番号の精度: 全国町・字ファイルを基に設定しているため、所在地に外字が含まれる場合や誤字脱字がある場合、正確な郵便番号が設定されないことがあります
• インボイス登録番号: qualified_invoice_issuer_number が非nullでも、当該法人が適格請求書発行事業者であるとは限りません。登録の有無は 適格請求書発行事業者API で確認してください
• カナ・ローマ字の技術的制約: prefecture_kana / city_kana / city_roman は2024年1月現在、技術的制約のため空文字列となります

**② 法人情報検索API (Reverse Lookup) **

GET /v1/houjinbangou?q=… (法人情報検索)この見出しへのリンク

法人名・所在地・フリガナ・インボイス登録番号などのキーワードから、該当する法人番号レコードを検索します。Forward Lookup が「13桁の法人番号を渡してピンポイントで引く」のに対し、本APIは「条件に合致する法人を絞り込む」用途。

リソースURLこの見出しへのリンク

https://api.kenall.jp/v1/houjinbangou?q=...&offset=...&limit=...&mode=...&facet_area=...&facet_kind=...&facet_process=...&facet_close_cause=...

クエリパラメータ (10件)この見出しへのリンク

クエリの禁止文字 (Tantivy構文)この見出しへのリンク

法人情報検索APIの全文検索エンジンには Tantivy を使用しています。Tantivy のクエリ構文上、以下の文字はクエリ文字列に含めると HTTP 400 が返ります。

これらの文字を含む法人名 (例: 株式会社A(仮)) を検索する場合は、問題となる文字を除いた部分文字列でクエリを送ってください。

検索対象フィールド (13件)この見出しへのリンク

クエリ q で「項目名:値」の形式を使うと、特定の項目だけを検索できます。例: name:オープンコレクター AND _facet_area:/東京都

検索モードこの見出しへのリンク

法人名の検索モード (mode) は、デフォルトの部分一致のほか、完全一致 (法人種別込み) と完全一致 (法人種別抜き) の3モードを提供します。法人名以外のフィールドは常に部分一致検索です。

• **部分一致 (partial・デフォルト) **: オープンコレクター で検索すると 株式会社○○オープンコレクター / オープンコレクター株式会社 / 株式会社オープンコレクター などがヒット
• **完全一致・法人種別抜き (exact) **: オープンコレクター で検索すると法人種別を無視して一致し、オープンコレクター株式会社 / 株式会社オープンコレクター がヒット
• **完全一致・法人種別込み (exact_with_kind) **: 株式会社オープンコレクター で検索すると 株式会社オープンコレクター のみがヒット

完全一致 (法人種別抜き) で省略可能な法人種別この見出しへのリンク

mode=exact では、以下の法人種別を法人名から省略しても一致させることができます。

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

検索クエリの正規化この見出しへのリンク

検索キーワードは自動的に正規化されるため、入力文字列のフォーマットを揃える必要はありません。正規化の対象フィールドは name / en_name / furigana / address_outside / street_number です。

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

• 全角・半角の正規化: 全角・半角を区別しません。例: ｵｰﾌﾟﾝｺﾚｸﾀｰ (半角カナ) → オープンコレクター
• かな小文字の正規化: 拗音 (ゃ・ゅ・ょ) 、促音 (っ) 、ヵ・ヶ・ぁぃぅぇぉ について大文字・小文字を区別しません。例: キヨウトフ → キョウトフ / キヨウトフ のどちらも検索。ただし完全一致検索では正規化しません。
• 歴史的仮名遣いの正規化: ゐ・ゑ はそれぞれ い・え と区別しません。例: ゐろはにほへと → ゐろはにほへと / いろはにほへと のどちらも検索。ただし完全一致検索では正規化しません。
• 旧字体・非標準文字の正規化: 旧字体・異体字・新字体を区別しません (下記参照) 。

en_name は全角・半角の正規化のみ行われます。

旧字体・非標準文字の正規化この見出しへのリンク

旧字体や非標準文字による検索に対応しており、非JIS漢字を含む登記簿上の法人名でもそのまま検索できます。

• 髙橋 (はしご高) → 高橋 を検索 (はしご高は非JIS漢字のため法人番号データには未収録)
• 計畫 → 計画 あるいは 計畫 を検索
• 株式會社オープンコレクター → 株式会社オープンコレクター を検索

一部未対応の漢字もあります。詳細は 既知の問題 を参照してください。

法人名の正規化 (normalize_name)この見出しへのリンク

クエリパラメータ normalize_name=true を指定すると、法人名が以下のように正規化されます。

• 全角英数字を半角英数字に変換
• ハイフンや長音などの記号 (長音状記号) を変換
  • 長音状記号の直前の文字が英数字の場合は半角ハイフン - に変換
  • それ以外の場合は全角長音 ー に変換
• 例1: ａｂｃ－ｄｅｆ → abc-def
• 例2: あいう－えお → あいうーえお

ファセットこの見出しへのリンク

ファセットのパス名は必ず / で始まり、各階層は / で区切られます (ルート階層は /) 。以下の4種類があり、facet_* クエリパラメータまたはクエリ内の _facet_* で指定します。

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

curl サンプルこの見出しへのリンク

# 法人名で部分一致検索
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/houjinbangou?q=オープンコレクター"
 
# 法人名 × 地域ファセット
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://api.kenall.jp/v1/houjinbangou?q=オープンコレクター+AND+_facet_area:/東京都"

レスポンス例この見出しへのリンク

{
  "version": "2021-08-20",
  "data": [
    { ... },
    { ... },
    { ... }
  ],
  "query": "name:...",
  "count": 3,
  "offset": 0,
  "limit": 100,
  "facets": {
    "area": [
      ["/大阪府", 2],
      ["/東京都", 1]
    ],
    "kind": [
      ["/合同会社", 1],
      ["/有限会社", 1],
      ["/株式会社", 1]
    ],
    "process": [
      ["/吸収合併", 1],
      ["/国内所在地の変更", 1],
      ["/新規", 1]
    ],
    "close_cause": [
      ["/その他", 2],
      ["/合併による解散等", 1]
    ]
  }
}

レスポンス・トップレベルフィールド (法人情報検索)この見出しへのリンク

facets オブジェクトのフィールド仕様 (4ファセット)この見出しへのリンク

POST /v1/batch/houjinbangou/search (バッチ法人情報検索)この見出しへのリンク

リクエストボディこの見出しへのリンク

queries 配列内の問い合わせレコードこの見出しへのリンク

curl サンプルこの見出しへのリンク

curl -X POST -H "Authorization: Token YOUR_SECRET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "default_limit": 1,
    "queries": [
      {"q": "オープンコレクター AND _facet_area:/東京都", "limit": 3}
    ]
  }' \
  "https://api.kenall.jp/v1/batch/houjinbangou/search"

レスポンス例この見出しへのリンク

{
  "version": "2025-04-28",
  "params": {
    "default_limit": 1
  },
  "records": [
    {
      "query": "オープンコレクター AND _facet_area:/東京都",
      "count": 1,
      "offset": 0,
      "limit": 3,
      "facets": null,
      "id": null,
      "data": [ /* 法人番号レコード (Forward Lookup と同構造) */ ]
    }
  ]
}

レスポンス・トップレベル (バッチ)この見出しへのリンク

**③ 法人番号レーダー (Radar) **

法人番号レーダーこの見出しへのリンク

法人番号レーダーは、事前に登録した法人番号の情報が変更されたことを毎日チェックし、Webhook で通知する機能です。Forward Lookup が単一法人の最新情報をその場で取得する同期APIなのに対し、レーダーは継続的な変更監視を目的とした非同期サブスクリプションです。

使い方の流れこの見出しへのリンク

1. ダッシュボード「法人番号レーダー」画面で Webhook URL を登録
2. 本APIから監視対象の法人番号を登録 (POST add)
3. ケンオール側で毎日更新チェックを自動実行
4. 変更検知時、登録 URL に Webhook 通知 (日付付き URL を含む)
5. Webhook で受け取った URL (GET /v1/houjinbangou/radar/{date}) を叩いて、当日更新があった法人番号一覧を取得
6. 必要に応じて 法人番号API で各法人の詳細情報を取得

GET /v1/houjinbangou/radar/corporate_numbersこの見出しへのリンク

監視対象として登録済みの法人番号一覧を取得します。

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_SECRET_KEY" \
  https://api.kenall.jp/v1/houjinbangou/radar/corporate_numbers

レスポンス例この見出しへのリンク

{
  "data": [
    "1234567890111",
    "1234567890222",
    "1234567890333"
  ]
}

POST /v1/houjinbangou/radar/corporate_numbers/addこの見出しへのリンク

監視対象の法人番号を登録します。

リクエストボディこの見出しへのリンク

備考: すでに登録済みの法人番号が含まれていても成功します。

curl サンプルこの見出しへのリンク

curl -X POST \
  -H "Authorization: Token YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": ["1000000000001", "1000000000002", "1000000000003"]}' \
  https://api.kenall.jp/v1/houjinbangou/radar/corporate_numbers/add

レスポンス例この見出しへのリンク

{
  "data": [
    "1234567890111",
    "1234567890222",
    "1234567890333"
  ]
}

POST /v1/houjinbangou/radar/corporate_numbers/removeこの見出しへのリンク

監視対象の法人番号を削除します。

リクエストボディこの見出しへのリンク

備考: 登録されていない法人番号が含まれている場合、登録されているもののみ削除されます (エラーにはなりません)。

curl サンプルこの見出しへのリンク

curl -X POST \
  -H "Authorization: Token YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": ["1000000000001"]}' \
  https://api.kenall.jp/v1/houjinbangou/radar/corporate_numbers/remove

成功時は HTTP 200・ボディなし。

Webhook 通知 (受信側エンドポイント)この見出しへのリンク

ケンオール側で変更を検知すると、ダッシュボードに登録された Webhook URL に対して以下の JSON が POST されます。

受信ボディこの見出しへのリンク

{
  "url": "https://api.kenall.jp/v1/houjinbangou/radar/2023-02-22",
  "date": "2023-02-22"
}

GET /v1/houjinbangou/radar/{date}この見出しへのリンク

指定日付に更新があった法人番号一覧を取得します。Webhook の url をそのまま叩く形になります。

curl サンプルこの見出しへのリンク

curl -H "Authorization: Token YOUR_SECRET_KEY" \
  https://api.kenall.jp/v1/houjinbangou/radar/2023-02-22

レスポンス例この見出しへのリンク

{
  "data": [
    "1234567890111",
    "1234567890222",
    "1234567890333"
  ]
}

各法人の詳細情報が必要な場合は、上記の法人番号それぞれに対して GET /v1/houjinbangou/{法人番号} を叩いてください。

共通仕様

HTTP ステータス・エラーこの見出しへのリンク

SDK で呼び出すこの見出しへのリンク

JavaScript SDK (法人番号検索)この見出しへのリンク

import { KENALL } from '@ken-all/kenall';
 
const api = new KENALL('YOUR_API_KEY');
 
const result = await api.getCorporation('2021001052596');
console.log(result.data.name);          // => 株式会社オープンコレクター
console.log(result.data.address.postal_code); // => 1020083

Python (requestsで代替)この見出しへのリンク

import os, requests
 
API_KEY = os.environ["KENALL_API_KEY"]
HEADERS = {"Authorization": f"Token {API_KEY}"}
 
# 法人情報取得
res = requests.get(
    "https://api.kenall.jp/v1/houjinbangou/2021001052596",
    headers=HEADERS, timeout=10,
)
res.raise_for_status()
data = res.json()["data"]
print(data["name"])                  # => 株式会社オープンコレクター
print(data["address"]["postal_code"]) # => 1020083
 
# レーダー: 監視対象追加 (シークレットキー必須)
SECRET = os.environ["KENALL_SECRET_KEY"]
res = requests.post(
    "https://api.kenall.jp/v1/houjinbangou/radar/corporate_numbers/add",
    headers={"Authorization": f"Token {SECRET}", "Content-Type": "application/json"},
    json={"data": ["2021001052596", "1000000000001"]},
    timeout=10,
)

→ SDK 一覧

OpenAPI スキーマこの見出しへのリンク

OpenAPI スキーマ (YAML): 2023-09-01 / 2024-01-01 / 2025-01-01

このAPIに関する技術FAQこの見出しへのリンク

関連リファレンスこの見出しへのリンク

• ⚠️ 既知の問題 (このAPIに該当する制約・破壊的変更)
• API共通仕様 — Token認証 / HTTPステータス / バージョニング / リクエスト回数の制限
• 適格請求書発行事業者API — インボイス登録番号 (T+13桁) の検証
• 郵便番号→住所API — 法人住所の正規化に併用
• JavaScript SDK ドキュメント

外部参考リソースこの見出しへのリンク

• 国税庁『法人番号公表サイト』 — 元データの出典

最終更新: 2026-07-14