使う（有料プラン）

データAPI

APIキーをヘッダに付けて GET で呼ぶと、JSON が返ります。APIキーはアカウント・お申し込みで発行します（有料プラン）。

共通

項目	内容
呼び出し先	`https://www.ikachi.org/houjin/pro/v1` に続けて下の3つのどれか
キー	ヘッダ `X-API-Key: hpk_...`（`Authorization: Bearer hpk_...` でも可）
応答	`{"success": true, "data": {...}, "usage": {...}}`
回数	1日 10,000 回・1分 600 回まで（日本時間の0時に戻ります）。データを返した呼び出し（200）だけ数えます

curl "https://www.ikachi.org/houjin/pro/v1/companies?date=2026-10-22&pref=13&limit=2" \
  -H "X-API-Key: hpk_あなたのキー"

GET/days

取り込み済みの日（国税庁の公表日）と、その日の新設法人の数。新しい日から。

GET/companies

新設法人の一覧です。新しい日から並びます。

指定	内容
`date`	1日だけ（`YYYY-MM-DD`）。`from`・`until` と一緒には使えません
`from` / `until`	期間（`YYYY-MM-DD`）。省略するといちばん新しい日
`pref`	都道府県コード（2桁。国外は `99`）
`city`	市区町村の名前の一部
`kind`	法人種別のコード（カンマ区切りで複数可）：`301` 株式会社／`305` 合同会社／`399` 一般社団法人など／`302` 有限会社／`303` 合名会社／`304` 合資会社／`401` 外国会社など／`101` 国の機関／`201` 地方公共団体／`499` その他の団体
`q`	社名・フリガナに含む言葉
`limit` / `offset`	返す件数 1〜1000（既定 100）／先頭から飛ばす件数

返ってくるもの

{
  "success": true,
  "data": {
    "total": 12,
    "has_more": false,
    "items": [
      {
        "published_date": "2026-09-16",
        "corporate_number": "1234567890123",
        "name": "株式会社〇〇",
        "furigana": "〇〇",
        "kind": { "code": "301", "name": "株式会社" },
        "prefecture": { "code": "13", "name": "東京都" },
        "city": "千代田区",
        "street": "〇〇一丁目1番1号",
        "postal_code": "1000001",
        "nta_url": "https://www.houjin-bangou.nta.go.jp/henkorireki-johoto.html?selHouzinNo=1234567890123"
      }
    ]
  },
  "usage": { "used_today": 1, "limit_today": 10000 }
}

GET/changes/{法人番号}

その法人の変化の履歴（新規・商号変更・所在地の変更・閉鎖・合併など）です。新しい順。記録は 2026-07-22 公表分からあります。

{
  "success": true,
  "data": {
    "corporate_number": "1234567890123",
    "changes": [
      { "date": "2026-09-16", "process": { "code": "12", "name": "所在地の変更（国内）" }, "correction": false,
        "name": "株式会社〇〇", "prefecture": { "code": "13", "name": "東京都" }, "city": "港区", "street": "…",
        "postal_code": "…", "close": null, "successor_corporate_number": null }
    ]
  }
}

エラー

HTTP	code	意味
400	`invalid_parameter`	指定の値が正しくない
401	`missing_api_key` / `invalid_api_key`	キーが無い・正しくない・再発行で無効になった
402	`plan_required`	有料プランではない（解約して期間が終わった）
403	`account_disabled`	アカウントが停止されている
404	`not_found` / `invalid_corporate_number`	呼び出し先が無い・法人番号が正しくない
405	`method_not_allowed`	GET 以外で呼んだ
429	`rate_limited` / `quota_exceeded`	1分・1日の上限を超えた（`Retry-After` 秒後に再試行）
500	`internal_error`	サーバーのエラー