エキスパートエンタープライズサブスクリプションサービス 法人番号サービス

概要

法人番号サービスは、法人番号や法人名などから法人情報を検索・取得できるWeb APIです。経済産業省 gBizINFO の基本情報を整理した法人番号データを基にしており、法人番号（13桁）・法人名・所在地などの条件から目的の法人情報を素早く取得できます。

検索結果は1件でも複数件でも同一形式で返却され、json / toml の出力形式を選択できます。

主な機能

• 法人番号（13桁）からの直接取得
• 法人番号・法人名・都道府県・市区町村・法人種別・郵便番号による検索
• 複数条件のAND結合による絞り込み
• 完全一致（既定）に加え、部分一致（partial=1 による %値% 照合）に対応
• ワイルドカード照合（*＝0文字以上、?＝1文字）に対応（partial より優先）
• 法人番号は区切り（-・空白）を除去して照合
• 最大返却件数の指定（max。既定・上限とも1000件）
• 出力形式の選択（format=json / format=toml）

API

すべてのエンドポイントはHTTP GETで、公開ベースURL配下に提供されます。

• 公開ベースURL: https://corporatenumber.expert-g.cloud/

エンドポイント

メソッド	パス	説明
GET	/corporatenumber/{number}	法人番号から法人情報を取得（検索と同一形式で返却）
GET	/corporatenumber/search	複数条件で検索
GET	/health	ヘルスチェック

パラメータ

検索フィールド（/corporatenumber/search で複数指定可・AND結合）:

パラメータ	説明	例
number	法人番号（corporate_number）	number=1010003019382
name	法人名（name）	name=エキスパート
pref	都道府県コード（pref_code）	pref=13
city	市区町村コード（city_code）	city=207
kind	法人種別コード（kind）	kind=305
postal	郵便番号（postal_code）	postal=1000001

共通パラメータ:

パラメータ	説明	例
partial	1 を指定すると各条件を部分一致（%値%）で照合	partial=1
max	最大返却件数（既定1000・上限1000）	max=50
format	出力形式 json（既定）/ toml	format=toml
cacheSeconds	キャッシュ期間（秒・0〜31536000）	cacheSeconds=3600

照合方式:

• 完全一致が既定です。
• partial=1 を付けると各条件を %値% で部分一致照合します。
• 値に *（0文字以上）または ?（1文字）を含めるとワイルドカード照合になります（partial より優先）。
• number は区切り（-・空白）を除去して照合します（ワイルドカード指定時は除去しません）。

リクエスト例

# 法人番号から取得
curl "https://corporatenumber.expert-g.cloud/corporatenumber/1010003019382"

# 法人名の部分一致検索
curl "https://corporatenumber.expert-g.cloud/corporatenumber/search?name=エキスパート&partial=1"

# ワイルドカード検索 + 都道府県コード指定 + TOML出力
curl "https://corporatenumber.expert-g.cloud/corporatenumber/search?pref=13&name=*商事*&format=toml"

レスポンス例

結果は1件でも複数件でも同一形式で返却され、results は常に配列です。

{
  "query": { "number": "1010003019382" },
  "count": 1,
  "results": [
    {
      "corporate_number": "1010003019382",
      "name": "...",
      "kind": "305",
      "postal_code": "...",
      "pref_code": "16",
      "city_code": "207",
      "location": "...",
      "close_date": "",
      "update_date": "2015-10-26"
    }
  ]
}

format=toml を指定した場合は、count と [[results]] テーブル配列で返却されます（null値は空文字）。 条件不正の場合は {"error": "..."} を返します。

ライセンス

本サービスはエキスパートエンタープライズサブスクリプションサービスで提供されます。

• ライセンス詳細: LICENSE

サービス

• エキスパートエンタープライズサブスクリプションサービス

会社情報

• 株式会社エキスパートエンタープライズ
• 株式会社エキスパートソフトウェア