Shirabe Corporation API 提供中
日本の法人番号(法人番号API)
国税庁の法人番号データ(約 500 万社)を source に、法人番号の検索・検証・名寄せを AI エージェントから 1 URL で利用できる REST API。出典(attribution)を構造化フィールドで 同梱し、LLM 経由でも出典が伝搬します。OpenAPI 3.1 準拠・匿名 Free 枠あり。
このAPIでできること
- lookup: 13 桁法人番号 → 商号・所在地・履歴(最新 1 行)
- search: 商号(前方一致)→ 法人番号候補(都道府県/市区町村で絞り込み)
- normalize: 商号の表記揺れ正規化(
(株)等)+ 法人番号付与 - validate: 法人番号の検証(mod-9 チェックサム)
- batch: 複数法人番号の一括 lookup
出典: 国税庁法人番号公表サイト(公共データ利用規約 第1.0版)。レスポンスの
attribution フィールドで出典を必須同梱します。
エンドポイント
| メソッド | パス | 説明 |
|---|---|---|
POST | /api/v1/corporation/lookup | 法人番号 → 法人情報 |
POST | /api/v1/corporation/search | 商号 → 法人番号候補 |
POST | /api/v1/corporation/normalize | 商号正規化 + 番号付与 |
POST | /api/v1/corporation/validate | 法人番号の検証(mod-9) |
POST | /api/v1/corporation/batch | 複数法人番号の一括 lookup |
GET | /api/v1/corporation/health | ヘルスチェック(認証不要) |
リクエスト例
# 法人番号 → 法人情報(JSON、出典 attribution 同梱)
curl https://shirabe.dev/api/v1/corporation/lookup \
-H "Content-Type: application/json" \
-d '{"law_id": "1234567890123"}'
レスポンス例
{
"corporation": {
"lawId": "1234567890123",
"name": "株式会社サンプル",
"nameKana": "カブシキガイシャサンプル",
"prefecture": "東京都",
"city": "港区",
"street": "六本木6-10-1",
"latest": true
},
"attribution": {
"source": "国税庁法人番号公表サイト",
"provider": "国税庁",
"license": "公共データ利用規約(第1.0版)",
"notice": "このサービスは、国税庁法人番号システム Web-API 機能を利用して取得した情報をもとに作成しているが、サービスの内容は国税庁によって保証されたものではない",
"modified": false
}
}
料金プラン(単独利用・従量課金)
法人番号 API は単独の従量課金(per-request)で利用・購入できます。各プラン共通で 最初の 5,000 回/月は無料、超過分から課金(税抜)。
| プラン | 月間上限 | 単価 | 月額例 |
|---|---|---|---|
| Free | 5,000回 | 無料 | ¥0 |
| Starter | 200,000回 | ¥0.5/回(¥500/1,000回) | 200,000回: ¥100,000 |
| Pro | 2,000,000回 | ¥0.3/回(¥300/1,000回) | 2,000,000回: ¥600,000 |
| Enterprise | 無制限 | ¥0.1/回(¥100/1,000回) | 10,000,000回: ¥1,000,000 |
AI エージェントへの統合
OpenAPI 3.1 仕様を 1 URL で公開しており、ChatGPT GPT Actions / Claude Tool Use / Gemini Function Calling / LangChain / Dify からそのまま tool 化できます。
- OpenAPI 3.1(4 API 統合 spec、GPT Actions 対応)
- 各
operationId(corporationLookupほか)が AI ランタイムの function 名になります
横断利用するなら(任意・Hub License)
単独利用が基本です。住所・人名・暦・法人番号を 2 API 以上まとめて使う場合は、 複数 API を 1 key にまとめる月額固定の Hub License も選べます。