JAPAN API STORE

AI Toolの使い分け

使うとき

この会社は実在するか確認したい
法人番号や正式所在地を調べたい
取引先企業を候補付きで照合したい

使わないとき

インボイス登録状態だけを確認する場合
企業名の表記統一だけを行う場合

推奨Tool Call: japan_company_verify({"query":"株式会社サンプル","prefecture":"東京都"})

入力・出力schema

POST `/v1/japan/company/verify`

必須入力

query: 企業名、13桁の法人番号、またはT付き登録番号

任意入力

prefecture: 都道府県
limit: 候補数（1〜20）

返却内容

法人存在判定
正式名称・法人番号・所在地
一致度と候補
法人状態と公的データ更新日

OpenAPI 3.1 / JSON Schemaを確認

実行例

curl -X POST https://api.japanapistore.com/v1/japan/company/verify \
  -H "Authorization: Bearer ${JAPAN_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"query":"株式会社サンプル","prefecture":"東京都"}'

JSONリクエスト

{
  "query": "株式会社サンプル",
  "prefecture": "東京都"
}

JSONレスポンス

{
  "success": true,
  "data": {
    "exists": true,
    "status": "matched",
    "official_name": "株式会社サンプル",
    "corporate_number": "1180301018771",
    "address": "東京都千代田区…"
  },
  "confidence": 0.92,
  "source": [
    {
      "source_id": "official_source",
      "name": "公的データ",
      "url": null,
      "updated_at": null
    }
  ],
  "updated_at": "2026-09-04T00:00:00.000Z",
  "request_id": "req_0123456789abcdef0123456789abcdef",
  "warnings": []
}

失敗例

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "入力内容を確認できませんでした。",
    "retryable": false,
    "suggested_action": "必須項目と型をOpenAPIで確認してください。"
  },
  "request_id": "req_0123456789abcdef0123456789abcdef"
}

401、403、429、500、503も同じ機械可読構造で返ります。429と5xxはretryable: trueです。

判定可能範囲・判定不能条件

同名法人が複数ある場合は一意に断定しません。
公的ソースが停止中の場合は明確な再試行可能エラーを返します。

すべての応答でconfidence、source、updated_at、warningsを確認してください。