{"openapi":"3.1.0","info":{"title":"Japan Business Identity API / 日本企業・ビジネス情報API — API key","description":"### Featured endpoints / 主要API\nHighest-value endpoints first; the full list below follows the same order. / 単価の高い順に表示しています。\n\n| Endpoint | Price | What it does |\n|---|---|---|\n| `POST /v1/jp/entities/resolve` | $0.50 | Resolve Japanese Entity from English Name or Identifier |\n| `POST /jp-business-card/extract-and-enrich` | $0.10 | Extract and Enrich Japanese Business Card |\n| `POST /v1/invoices/issuer-match/extract` | $0.10 | Extract and Match Japanese Invoice Issuer |\n| `POST /jp-company/report` | $0.05 | Generate Japanese Company KYB Report |\n| `POST /v1/invoices/counterparty-check` | $0.05 | Invoice Counterparty Check |\n| `GET /v1/entities/{entity_id}/filing-risk-snapshot` | $0.05 | Filing Risk Snapshot |\n| `POST /jp-company/verify-batch` | $0.05 | Verify Japanese Companies in Batch |\n| `POST /jp-invoice/verify-batch` | $0.05 | Verify Japanese Invoice Numbers in Batch |\n\nPay per successful request from **prepaid USD credits** with an account API key. Prices are the same as x402. Failed or invalid requests are refunded automatically. / アカウントのAPI Keyを使い、前払いクレジット（米ドル）から成功したリクエストごとに支払います。料金はx402と同じで、失敗・入力不正のリクエストは課金されません。\n\n### 1. Get a key / API Keyを取得\nCreate a free account at https://www.jpverify.com/signup (new accounts get free starter credits), then create a key at https://www.jpverify.com/account/keys and store it as `JPVERIFY_API_KEY`.\n\n### 2. Call the API / 呼び出し例\nSend the key as `Authorization: Bearer jpv_live_…` (or `X-API-Key: jpv_live_…`). On this page, click **Authorize** to try requests with your key.\n\n**curl**\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-invoice/verify \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"registration_number\": \"T1013301046627\"}' \\\n  -i   # -i shows X-JPVerify-Credits-Charged / -Remaining\n```\n\n**Python**\n\n```python\n# pip install requests\nimport os\nimport requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-invoice/verify\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"registration_number\": \"T1013301046627\"},\n    timeout=60,\n)\nprint(response.status_code, response.headers.get(\"X-JPVerify-Credits-Remaining\"))\nif response.status_code == 402:      # insufficient_credits: top up, nothing was charged\n    print(response.json()[\"top_up_url\"])\nelse:\n    response.raise_for_status()      # 401 invalid_api_key, 422 invalid input (not charged)\n    print(response.json())\n```\n\n**JavaScript**\n\n```javascript\n// Node.js 18+ (built-in fetch)\nconst response = await fetch(\"https://api.jpverify.com/jp-invoice/verify\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"registration_number\": \"T1013301046627\"}),\n});\nconsole.log(response.status, response.headers.get(\"X-JPVerify-Credits-Remaining\"));\nconsole.log(await response.json());\n```\n\n**MCP**\n\n```bash\n# Claude Code\nclaude mcp add --transport http jpverify https://api.jpverify.com/mcp \\\n  --header \"Authorization: Bearer $JPVERIFY_API_KEY\"\n\n# Any MCP client (mcp.json)\n{\"mcpServers\": {\"jpverify\": {\"type\": \"http\", \"url\": \"https://api.jpverify.com/mcp\",\n  \"headers\": {\"Authorization\": \"Bearer jpv_live_...\"}}}}\n```\n\n### 3. Responses / レスポンス\n| Status | Meaning | Charged |\n|---|---|---|\n| `200` | Success. Headers `X-JPVerify-Credits-Charged` and `X-JPVerify-Credits-Remaining` show the cost and balance. | Listed price |\n| `401 invalid_api_key` | Key missing, malformed, unknown or revoked. | No |\n| `402 insufficient_credits` | Balance lower than the price; body has `top_up_url` (https://www.jpverify.com/account/billing). | No |\n| `422` | Invalid input. | No |\n| `5xx` | Server or upstream error. | No (refunded) |\n\n**x402 only:** async batch jobs (`/v1/batch-jobs`) and the A2A agent — see the x402 docs at `/docs/x402`. / 非同期バッチとA2Aはx402専用です。\n","version":"0.5.0","termsOfService":"/terms","contact":{"name":"DSテクニック","email":"service@jpverify.com"}},"servers":[{"url":"https://api.jpverify.com","description":"Public API base URL"}],"paths":{"/v1/jp/entities/resolve":{"post":{"summary":"Resolve Japanese Entity from English Name or Identifier","description":"Identify a Japanese legal entity from an English or romanized name, postal code or prefecture, T-number, corporate number, LEI or securities code. Identifiers give `matched`; a name alone gives `likely_match` (only with a matching postal code) or `candidates`. The Japanese registered name is the legally binding name; English names carry their source. Evidence summary from official open data, not a certified registry extract. / 英語名や識別番号から日本の法人を特定します。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/v1/jp/entities/resolve \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"Murata Manufacturing Co., Ltd.\", \"prefecture\": \"Kyoto\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/v1/jp/entities/resolve\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"name\": \"Murata Manufacturing Co., Ltd.\", \"prefecture\": \"Kyoto\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/v1/jp/entities/resolve\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"name\": \"Murata Manufacturing Co., Ltd.\", \"prefecture\": \"Kyoto\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_entity_resolve_route_v1_jp_entities_resolve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JpEntityResolveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JpEntityResolveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Entity Resolve (English)","x-agent-use":"Identify a Japanese company from what foreign teams hold: an English or romanized name with postal code or prefecture, or a T-number, corporate number, LEI or securities code. Identifiers resolve exactly; a name alone returns candidates. Returns, in English, the legally binding Japanese name, kana, English name with source, status and qualified-invoice registration. Keywords: Japanese company English name lookup, KYB, vendor onboarding, 法人番号. / 英語名や識別番号から日本の法人を特定します。","x-agent-selection":{"use_when":"You hold an English or romanized Japanese company name, postal code, T-number, corporate number, LEI or securities code and need the Japanese legal entity, in English.","use_when_ja":"英語名・ローマ字・郵便番号・T番号・法人番号・LEI・証券コードから日本の法人を特定したい場合。","returns":"Decision (matched / likely_match / candidates), legally binding Japanese name, kana, English name with source, contract party name, status and qualified-invoice registration.","returns_ja":"判定、正式な日本語商号、読み、出典付き英語名、契約当事者名、状態、適格請求書登録を返します。","keywords":["Japanese company English name lookup","find Japanese corporate number","vendor onboarding Japan","KYB Japan","法人番号 検索 英語"]},"x-price-usd":"$0.50","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-business-card/extract-and-enrich":{"post":{"summary":"Extract and Enrich Japanese Business Card","description":"Extract one Japanese or multilingual business card, then match its organization against Japan's public corporate-number registry and qualified-invoice registry. Returns match evidence, address mismatch status, possible branch-or-office indication, corporate number, and invoice status. Local snapshot resolution is used before live/fallback registry verification. This is a registry pre-check, not full KYB, AML, UBO, sanctions, financial, or personal-identity verification. The API always returns JSON; output_format=vcard additionally includes a vCard 4.0 string. / 日本語または多言語の名刺1枚を抽出し、組織を日本の法人番号公表サイトおよび適格請求書発行事業者公表サイトと照合します。照合根拠、住所不一致、支店・営業所の可能性、法人番号、インボイス登録状態を返します。本機能は登記情報の事前確認であり、完全なKYB、AML、実質的支配者、制裁、財務、個人本人確認ではありません。APIは常にJSONを返し、output_format=vcardの場合はvCard 4.0文字列を追加します。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-business-card/extract-and-enrich \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"front_image_url\": \"https://www.jpverify.com/samples/business-card-front.png\", \"back_image_url\": \"https://www.jpverify.com/samples/business-card-back.png\", \"output_format\": \"json\", \"include_raw_text\": false, \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-business-card/extract-and-enrich\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"front_image_url\": \"https://www.jpverify.com/samples/business-card-front.png\", \"back_image_url\": \"https://www.jpverify.com/samples/business-card-back.png\", \"output_format\": \"json\", \"include_raw_text\": False, \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-business-card/extract-and-enrich\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"front_image_url\": \"https://www.jpverify.com/samples/business-card-front.png\", \"back_image_url\": \"https://www.jpverify.com/samples/business-card-back.png\", \"output_format\": \"json\", \"include_raw_text\": false, \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_business_card_extract_and_enrich_jp_business_card_extract_and_enrich_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardExtractRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessCardResponse"}}}},"429":{"description":"Local OCR queue is full; retry later. / ローカルOCRキューが満杯です。後で再試行してください。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardErrorResponse"}}}},"502":{"description":"The OCR model returned invalid output. / OCRモデルの出力が不正です。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardErrorResponse"}}}},"504":{"description":"The OCR model timed out; retry is possible. / OCRモデルがタイムアウトしました。再試行できます。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Card OCR Enrich","x-agent-use":"Japanese business card OCR and company verification (名刺OCR, 名刺読み取り). Extract front/back images (Base64 or HTTPS; one-page PDF, HEIF, TIFF) and resolve the organization against Japan's NTA corporate-number snapshot with live/fallback registry and qualified-invoice (T-number) data. Registry pre-check, not full KYB. / 名刺の表裏を抽出し、国税庁の法人番号スナップショットを優先して企業を照合し、必要に応じて法人番号・適格請求書（T番号）情報と照合します。完全なKYBではありません。","x-agent-selection":{"use_when":"You need business-card OCR plus Japanese corporate-number and qualified-invoice enrichment.","use_when_ja":"名刺OCRに加えて、日本の法人番号・適格請求書登録情報で企業を照合したい場合。","returns":"Separate card OCR values and registry-resolved company values; registry pre-check, not full KYB.","returns_ja":"名刺OCR値と登記照合済み企業値を分離して返します。完全なKYBではありません。","keywords":["business card enrichment","corporate number","名刺OCR","法人番号"]},"x-price-usd":"$0.10","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/v1/invoices/issuer-match/extract":{"post":{"summary":"Extract and Match Japanese Invoice Issuer","operationId":"jp_invoice_issuer_match_extract_v1_invoices_issuer_match_extract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceIssuerMatchExtractRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/_InvoiceIssuerMatchExtractResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Invoice Issuer Match with OCR","x-agent-use":"Read a Japanese invoice (text, HTTPS URL, Base64, PDF or image), then match its issuer to the supplier's expected T-number or corporate number and NTA registries. Issuer fields come only from OCR and cannot be overridden. Same decisions as /v1/invoices/issuer-match, plus the extraction. Keywords: invoice OCR, AP automation, 請求書OCR, 適格請求書, T番号, 仕入先照合. / 請求書を読み取り、発行者を仕入先マスターと国税庁データで照合します。","x-agent-selection":{"use_when":"Read an invoice document before matching it against supplier master data.","use_when_ja":"請求書を読み取って仕入先マスターと照合したい場合。","returns":"Issuer decision and separate document, expected and registry evidence.","returns_ja":"発行者の判定と請求書・仕入先マスター・登録情報を返します。","keywords":["invoice issuer match","supplier master data","請求書","仕入先マスター"]},"x-price-usd":"$0.10","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"],"description":"\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/v1/invoices/issuer-match/extract \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"text\": \"請求書 宏達株式会社 登録番号 T1013301046627 請求日 2026年10月31日 合計110,000円\", \"expected\": {\"registration_number\": \"T1013301046627\"}}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/v1/invoices/issuer-match/extract\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"text\": \"請求書 宏達株式会社 登録番号 T1013301046627 請求日 2026年10月31日 合計110,000円\", \"expected\": {\"registration_number\": \"T1013301046627\"}},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/v1/invoices/issuer-match/extract\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"text\": \"請求書 宏達株式会社 登録番号 T1013301046627 請求日 2026年10月31日 合計110,000円\", \"expected\": {\"registration_number\": \"T1013301046627\"}}),\n});\nconsole.log(response.status, await response.json());\n```\n"}},"/jp-company/report":{"post":{"summary":"Generate Japanese Company KYB Report","description":"Return a Japanese company KYB report with registry risk flags. / 登記状態とリスクフラグを含む日本企業のKYBレポートを返します。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-company/report \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"株式会社ABC\", \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-company/report\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"name\": \"株式会社ABC\", \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-company/report\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"name\": \"株式会社ABC\", \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_company_report_jp_company_report_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Company Report","x-agent-use":"Japanese company KYB pre-check. Keywords: company report Japan, corporate number, 法人番号, 日本企業調査. Return corporate number, registered name and address, active/closed registry status, match evidence, and risk flags from Japan's NTA data. Not full KYC or KYB. / 国税庁データに基づき、法人番号、法人名、住所、活動状態、一致根拠、リスクフラグを返します。完全なKYC・KYBではありません。","x-agent-selection":{"use_when":"You need a Japan company registry pre-check with risk flags.","use_when_ja":"日本企業の登記情報に基づく事前確認とリスクフラグが必要な場合。","returns":"Registry identity, status, evidence, and risk flags; not full KYC/KYB.","returns_ja":"登記上の企業情報、状態、根拠、リスクフラグを返します。完全なKYC/KYBではありません。","keywords":["company report Japan","KYB pre-check","法人番号","日本企業調査"]},"x-price-usd":"$0.05","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/v1/invoices/counterparty-check":{"post":{"summary":"Invoice Counterparty Check","description":"Check known EU VAT and Peppol identifiers with separate validity, entity-match, and discoverability results. VIES is not a name-search service and no upstream raw payload is returned.\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/v1/invoices/counterparty-check \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"vat_id\": \"DE123456789\", \"participant_id\": \"iso6523-actorid-upis::0088:123456789\", \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/v1/invoices/counterparty-check\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"vat_id\": \"DE123456789\", \"participant_id\": \"iso6523-actorid-upis::0088:123456789\", \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/v1/invoices/counterparty-check\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"vat_id\": \"DE123456789\", \"participant_id\": \"iso6523-actorid-upis::0088:123456789\", \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"invoice_counterparty_check_v1_invoices_counterparty_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceCounterpartyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceCounterpartyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Cross-Border Invoice Counterparty Check","x-agent-use":"Check a known EU VAT ID and/or Peppol participant using separate tax-validity, entity-match, and discoverability evidence. VIES is never used for name search and upstream responses are not resold. / 既知のEU VAT IDまたはPeppol参加者を税番号有効性・法人一致・到達性に分けて確認します。VIESは名称検索に使わず、元データは再販しません。","x-agent-selection":{"use_when":"You need separate EU VAT validity, returned-name entity matching, and Peppol participant discoverability evidence.","use_when_ja":"EU VAT有効性、返却名による法人一致、Peppol参加者到達性を分けて確認する場合。","returns":"Projected VIES and Peppol evidence only; VIES is known-ID validation and member-state outages are insufficient coverage.","returns_ja":"VIESとPeppolの加工済み根拠のみを返します。VIESは既知IDの検証であり、加盟国停止は対象範囲不足です。","keywords":["VIES","EU VAT validation","Peppol","invoice counterparty","VAT番号"]},"x-price-usd":"$0.05","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/v1/entities/{entity_id}/filing-risk-snapshot":{"get":{"summary":"Filing Risk Snapshot","description":"Return objective recent SEC EDGAR filing metadata and XBRL availability for a known CIK. Not a credit rating or investment advice.\n\n#### Example / 呼び出し例\n\n```bash\ncurl -G https://api.jpverify.com/v1/entities/0000320193/filing-risk-snapshot \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\"\n```\n\n```python\nimport os, requests\n\nresponse = requests.get(\n    \"https://api.jpverify.com/v1/entities/0000320193/filing-risk-snapshot\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/v1/entities/0000320193/filing-risk-snapshot\", {\n  method: \"GET\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n  }\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"filing_risk_snapshot_v1_entities__entity_id__filing_risk_snapshot_get","parameters":[{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","title":"Entity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingRiskSnapshotResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"SEC Filing Risk Snapshot","x-agent-use":"Return objective SEC EDGAR filing and disclosure metadata for a known CIK. This is not a credit rating or investment advice; results are cached and globally rate limited. / 既知のCIKについてSEC EDGAR提出書類と開示メタデータを返します。信用格付けや投資助言ではなく、結果はキャッシュされ全体レート制限されます。","x-agent-selection":{"use_when":"You need objective recent SEC EDGAR filing and XBRL availability metadata for a known CIK.","use_when_ja":"既知のCIKについてSEC EDGAR提出書類とXBRL開示状況の客観的メタデータを確認する場合。","returns":"Recent filing metadata and objective disclosure signals; never a credit rating or investment recommendation.","returns_ja":"最近の提出書類メタデータと客観的な開示シグナルを返します。信用格付けや投資助言ではありません。","keywords":["SEC EDGAR","CIK filings","XBRL facts","filing snapshot","開示書類"]},"x-price-usd":"$0.05","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-company/verify-batch":{"post":{"summary":"Verify Japanese Companies in Batch","description":"Verify up to ten Japanese companies in one request. / 1回のリクエストで最大10社の日本企業を検証します。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-company/verify-batch \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"items\": [{\"corporate_number\": \"1180301018771\"}], \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-company/verify-batch\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"items\": [{\"corporate_number\": \"1180301018771\"}], \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-company/verify-batch\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"items\": [{\"corporate_number\": \"1180301018771\"}], \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_company_verify_batch_jp_company_verify_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyBatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Company Batch Verify","x-agent-use":"Batch Japanese company verification / 日本企業法人番号一括検証: verify up to 10 company names, corporate numbers, or addresses against Japan's NTA registry in one paid request. Results preserve input order and expose per-item index, error, and retryable metadata. / 1回の有料リクエストで最大10件の会社名・法人番号・住所を国税庁データと照合します。","x-agent-selection":{"use_when":"You need up to 10 Japanese company or corporate-number lookups in one request.","use_when_ja":"最大10件の日本企業・法人番号を1回のリクエストで照合したい場合。","returns":"One result per input with match status and registry evidence.","returns_ja":"入力ごとの一致状態と登記根拠を返します。","keywords":["batch company verification","法人番号一括検証","corporate number"]},"x-price-usd":"$0.05","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-invoice/verify-batch":{"post":{"summary":"Verify Japanese Invoice Numbers in Batch","description":"Verify up to ten Japanese invoice registration numbers in one request; no OCR or issuer name/address comparison is performed. / 1回のリクエストで最大10件の日本の請求書登録番号を検証します。OCRや発行者名・住所の比較は行いません。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-invoice/verify-batch \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"registration_numbers\": [\"T1013301046627\"], \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-invoice/verify-batch\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"registration_numbers\": [\"T1013301046627\"], \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-invoice/verify-batch\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"registration_numbers\": [\"T1013301046627\"], \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_invoice_verify_batch_jp_invoice_verify_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceBatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Invoice Batch Verify","x-agent-use":"Batch Japanese qualified-invoice verification. Keywords: batch T-number verification, インボイス登録番号一括検証, 適格請求書. Verify up to 10 T+13 digit invoice registration numbers against Japan's NTA registry for accounting and AP workflows. Results preserve input order and expose per-item index, error, and retryable metadata. / 最大10件のT+13桁インボイス登録番号を国税庁データと照合し、会計・買掛金処理に利用できます。","x-agent-selection":{"use_when":"You need up to 10 Japanese T-number checks in one request.","use_when_ja":"最大10件の日本のT番号を1回のリクエストで検証したい場合。","returns":"One NTA registration result per T-number.","returns_ja":"T番号ごとの国税庁登録結果を返します。","keywords":["batch T-number verification","インボイス登録番号一括検証","適格請求書"]},"x-price-usd":"$0.05","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-invoice/extract-and-verify":{"post":{"summary":"Extract, Verify, and Enrich Japanese Billing Invoice","description":"Extract and locally validate a Japanese billing invoice, verify its T-number, compare issuer name/address with NTA registries, and fill missing registry-backed issuer fields. Phone remains OCR-only. / 日本語の請求書を抽出・ローカル検証し、T番号を検証して、発行者名・住所を国税庁データと比較し、欠落項目を法人情報で補完します。電話番号はOCR値のみです。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-invoice/extract-and-verify \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"text\": \"登録番号 T1013301046627 合計110000円 消費税10000円\", \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-invoice/extract-and-verify\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"text\": \"登録番号 T1013301046627 合計110000円 消費税10000円\", \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-invoice/extract-and-verify\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"text\": \"登録番号 T1013301046627 合計110000円 消費税10000円\", \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_invoice_extract_and_verify_jp_invoice_extract_and_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceExtractVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceExtractVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Invoice Verify","x-agent-use":"Japanese billing-invoice OCR, local validation, and NTA issuer resolution. Keywords: invoice OCR, 請求書OCR, 適格請求書, インボイス登録番号, 法人番号, T番号. Checks dates, amounts, tax, T-number, and completeness; compares or fills issuer name and address. Phone remains OCR-only. Supports text, HTTPS URL, Base64, PDF, HEIF, and TIFF. / 日本語請求書OCR・ローカル検証・国税庁発行者照合。日付・金額・税額・T番号・必須項目を検証し、発行者名・住所を照合・補完します。電話はOCR値のみ。text、HTTPS URL、Base64、PDF、HEIF、TIFFに対応します。","x-agent-selection":{"use_when":"You need invoice OCR and issuer name/address comparison or completion using NTA public data.","use_when_ja":"請求書OCRに加えて、国税庁公開データで発行者名・住所・T番号を照合・補完したい場合。","returns":"OCR values, registry values, resolved issuer values, validation, and an explicit review signal.","returns_ja":"OCR値、登記値、採用した発行者値、検証結果、明示的な確認シグナルを返します。","keywords":["invoice verification","issuer check","適格請求書","インボイス登録番号","法人番号"]},"x-price-usd":"$0.05","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/v1/invoices/issuer-match":{"post":{"summary":"Match Japanese Invoice Issuer","operationId":"jp_invoice_issuer_match_v1_invoices_issuer_match_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceIssuerMatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceIssuerMatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Invoice Issuer Match","x-agent-use":"Match a Japanese invoice issuer to supplier master data: compares the invoice T-number, name and address with the supplier's expected T-number or corporate number and NTA registries, keeping the values separate. Decisions: issuer_matched, supplier_mismatch, document_conflict, registration_problem, insufficient_evidence. Keywords: AP, vendor master, 適格請求書, T番号, 法人番号. / 請求書の発行者を仕入先マスターの照合用番号・国税庁データと照合します。","x-agent-selection":{"use_when":"Match structured invoice fields against supplier master data.","use_when_ja":"構造化済みの請求書と仕入先マスターを照合したい場合。","returns":"Issuer decision and separate document, expected and registry evidence.","returns_ja":"発行者の判定と請求書・仕入先マスター・登録情報を返します。","keywords":["invoice issuer match","supplier master data","請求書","仕入先マスター"]},"x-price-usd":"$0.05","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"],"description":"\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/v1/invoices/issuer-match \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"document\": {\"registration_number\": \"T1013301046627\", \"issuer_name\": \"宏達株式会社\"}, \"expected\": {\"registration_number\": \"T1013301046627\"}}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/v1/invoices/issuer-match\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"document\": {\"registration_number\": \"T1013301046627\", \"issuer_name\": \"宏達株式会社\"}, \"expected\": {\"registration_number\": \"T1013301046627\"}},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/v1/invoices/issuer-match\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"document\": {\"registration_number\": \"T1013301046627\", \"issuer_name\": \"宏達株式会社\"}, \"expected\": {\"registration_number\": \"T1013301046627\"}}),\n});\nconsole.log(response.status, await response.json());\n```\n"}},"/v1/entities/resolve-cross-border":{"post":{"summary":"Resolve Cross-Border Entity Evidence","description":"Resolve a Japanese or UK business entity using a safe, country-routed evidence projection. The first release supports JP (NTA, qualified invoice, gBizINFO, address) and GB (Companies House); raw upstream responses are never returned. Hard identity conflicts are never verified. This is a public-evidence pre-check, not legal KYB, AML, sanctions, or identity clearance. / 国別に日本または英国の企業根拠を組み合わせて確認します。第一期はJP（国税庁、適格請求書、gBizINFO、住所）とGB（Companies House）に対応し、元データは返しません。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/v1/entities/resolve-cross-border \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"country_code\": \"GB\", \"identifiers\": {\"company_number\": \"00000006\"}, \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/v1/entities/resolve-cross-border\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"country_code\": \"GB\", \"identifiers\": {\"company_number\": \"00000006\"}, \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/v1/entities/resolve-cross-border\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"country_code\": \"GB\", \"identifiers\": {\"company_number\": \"00000006\"}, \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"resolve_cross_border_v1_entities_resolve_cross_border_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrossBorderEntityResolveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrossBorderEntityResolveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Cross-Border Entity Evidence Resolve","x-agent-use":"Resolve a JP or GB entity using projected official evidence from NTA/gBizINFO or Companies House; raw upstream responses are not returned. Hard identity conflicts are never verified. / 日本または英国の企業を公式根拠の加工済み投影で確認します。元データは返さず、識別子の矛盾はverifiedになりません。","x-agent-selection":{"use_when":"You need a JP or GB entity identity pre-check from one country-routed API; the first release uses NTA/gBizINFO for JP and Companies House for GB.","use_when_ja":"日本または英国の企業を国別に公式公開根拠で確認したい場合。第一期はJPが国税庁・gBizINFO、GBがCompanies Houseです。","returns":"Projected entity identity, evidence checks, source freshness, coverage, conflicts, and a conservative confidence band; raw upstream responses are never returned.","returns_ja":"加工済みの企業識別情報、根拠チェック、鮮度、対象範囲、矛盾、保守的な信頼度区分を返します。元データは返しません。","keywords":["cross-border entity verification","Companies House","UK company lookup","JP entity","国際企業照合"]},"x-price-usd":"$0.04","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-invoice/check":{"post":{"summary":"Check Invoice Issuer Against Japanese Registries","description":"Verify a supplied T-number and compare optional supplier name/address with NTA registries; this endpoint does not perform OCR. / 指定されたT番号を検証し、任意の発行者名・住所を国税庁データと比較します。このエンドポイントはOCRを行いません。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-invoice/check \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"registration_number\": \"T1013301046627\", \"supplier_name\": \"株式会社ABC\", \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-invoice/check\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"registration_number\": \"T1013301046627\", \"supplier_name\": \"株式会社ABC\", \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-invoice/check\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"registration_number\": \"T1013301046627\", \"supplier_name\": \"株式会社ABC\", \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_invoice_check_jp_invoice_check_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceCheckRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceCheckResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Invoice Issuer Check","x-agent-use":"Japanese billing-invoice issuer check. Keywords: invoice issuer check, 請求書発行者照合, 適格請求書, インボイス登録番号, 法人番号. Verify a T-number, compare issuer name and address with Japan's NTA qualified-invoice and corporate registries, and return OCR, registry, and resolved issuer fields. Phone numbers are not compared because they are not published in the NTA corporate registry. / T番号を検証し、発行者名・住所を国税庁の適格請求書および法人番号データと比較して、OCR値・登記値・採用値を返します。国税庁の法人番号データには電話番号がないため、電話番号は比較しません。","x-agent-selection":{"use_when":"You have extracted issuer fields and need T-number, company-name, and address comparison.","use_when_ja":"抽出済みの発行者情報について、T番号・会社名・住所を照合したい場合。","returns":"OCR issuer fields, NTA registry fields, comparison results, and resolved values; phone is not registry-compared.","returns_ja":"OCR発行者情報、国税庁登記情報、比較結果、採用値を返します。電話番号は登記比較しません。","keywords":["invoice issuer check","法人番号照合","請求書発行者照合","T番号"]},"x-price-usd":"$0.03","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-business-card/extract":{"post":{"summary":"Extract Japanese Business Card Data","description":"Extract printed contact and organization information from one Japanese or multilingual business card, optionally using front and back images. Returns names, titles, departments, emails, phones, websites, addresses, field confidence, and image-side provenance. This endpoint does not verify the company, person, card authenticity, or invoice status. A local corporate snapshot may improve the legal-company-name candidate without returning registry verification fields. The API always returns JSON; output_format=vcard additionally includes a vCard 4.0 string. / 日本語または多言語の名刺1枚から、表面・裏面画像（任意）を使って、氏名、役職、部署、メール、電話、Webサイト、住所、項目別信頼度、画像面の出典を抽出します。企業、個人、名刺の真正性、インボイス登録状態は検証しません。ローカル法人スナップショットで法人名候補を改善する場合がありますが、照合結果は返しません。APIは常にJSONを返し、output_format=vcardの場合はvCard 4.0文字列を追加します。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-business-card/extract \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"front_image_url\": \"https://www.jpverify.com/samples/business-card-front.png\", \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-business-card/extract\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"front_image_url\": \"https://www.jpverify.com/samples/business-card-front.png\", \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-business-card/extract\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"front_image_url\": \"https://www.jpverify.com/samples/business-card-front.png\", \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_business_card_extract_jp_business_card_extract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardExtractRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessCardResponse"}}}},"429":{"description":"Local OCR queue is full; retry later. / ローカルOCRキューが満杯です。後で再試行してください。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardErrorResponse"}}}},"502":{"description":"The OCR model returned invalid output. / OCRモデルの出力が不正です。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardErrorResponse"}}}},"504":{"description":"The OCR model timed out; retry is possible. / OCRモデルがタイムアウトしました。再試行できます。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardErrorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Business Card OCR","x-agent-use":"Japanese business card OCR for contact fields. Keywords: business card OCR, contact extraction. / 日本語の名刺OCR・名刺読み取り・名刺情報抽出。名刺に印刷された連絡先のみを抽出します。","x-agent-selection":{"use_when":"You need only the person, role, department, company, phone, email, or address printed on a Japanese business card.","use_when_ja":"日本語の名刺に印刷された氏名、役職、部署、会社名、電話、メール、住所だけが必要な場合。","returns":"Card-printed contact fields only; no corporate-number or NTA issuer verification.","returns_ja":"名刺に印刷された連絡先のみ。法人番号や国税庁発行者照合は含みません。","keywords":["business card OCR","名刺OCR","名刺読み取り","contact extraction"]},"x-price-usd":"$0.03","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-receipt/extract":{"post":{"summary":"Extract and Validate Japanese Receipt","description":"Extract a Japanese receipt, run local amount/tax/T-number consistency checks, and verify a detected qualified-invoice number. Phone, postal code, and address are format/structure only. / 日本語の領収書を抽出し、金額・税額・T番号の整合性をローカル検証して、検出した適格請求書番号を確認します。電話番号・郵便番号・住所は形式または構造のみを扱います。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-receipt/extract \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"text\": \"八福餃子房 2025年4月12日 21:18 登録番号 T1013301046627 合計12425円 内消費税1130円\", \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-receipt/extract\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"text\": \"八福餃子房 2025年4月12日 21:18 登録番号 T1013301046627 合計12425円 内消費税1130円\", \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-receipt/extract\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"text\": \"八福餃子房 2025年4月12日 21:18 登録番号 T1013301046627 合計12425円 内消費税1130円\", \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_receipt_extract_jp_receipt_extract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptExtractRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Receipt OCR","x-agent-use":"Japanese receipt OCR with local amount, tax, T-number, and contact-format checks; detected T-numbers are checked against the NTA invoice registry. Supports text, HTTPS URL, Base64, PDF, HEIF, and TIFF. Phone, postal code, and address are format/structure only. / 日本語領収書OCR。金額・税額・T番号・連絡先形式をローカル検証し、検出T番号を国税庁データと照合します。text、HTTPS URL、Base64、PDF、HEIF、TIFFに対応。電話・郵便番号・住所は形式・構造のみです。","x-agent-selection":{"use_when":"You need Japanese receipt or 領収書 OCR with local tax, amount, T-number, and format checks.","use_when_ja":"日本語の領収書・レシートをOCRし、金額・税額・T番号・形式を検証したい場合。","returns":"Structured receipt fields, deterministic validation, field status, and review signals.","returns_ja":"構造化された領収書項目、決定論的検証、項目状態、確認シグナルを返します。","keywords":["receipt OCR","領収書OCR","レシートOCR","T-number"]},"x-price-usd":"$0.03","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-regulated-entity/verify":{"post":{"tags":["Paid APIs — highest price first / 有料API（単価の高い順）"],"summary":"Verify FSA Regulated Entity","description":"Check a Japanese entity against covered Financial Services Agency licensing datasets and return freshness-aware evidence. Address/phone-only discovery is allowed, but weak identity alone never yields a verified decision; this is not a legal unlicensed determination. / 対象範囲内の金融庁免許データセットで日本法人を照合し、鮮度付き根拠を返します。住所・電話だけの探索は可能ですが、弱い識別情報だけでverified判定は返しません。無登録の法的判断ではありません。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-regulated-entity/verify \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"corporate_number\": \"1234567890123\", \"categories\": [\"funds_transfer_business\"], \"response_language\": \"en\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-regulated-entity/verify\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"corporate_number\": \"1234567890123\", \"categories\": [\"funds_transfer_business\"], \"response_language\": \"en\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-regulated-entity/verify\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"corporate_number\": \"1234567890123\", \"categories\": [\"funds_transfer_business\"], \"response_language\": \"en\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"verify_jp_regulated_entity_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegulatedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Regulated Entity Verify","x-agent-use":"Verify a Japanese FSA-regulated entity across the three V1 covered categories. / 日本の金融庁対象三分類で法人を照合します。","x-agent-selection":{"use_when":"You need to verify an entity against the covered Japanese FSA financial instruments, funds transfer, or crypto-asset exchange datasets.","use_when_ja":"金融商品、資金移動、暗号資産交換の対象事業者データセットで日本法人を照合する場合。","returns":"Coverage-aware licensing decision, freshness, identity match, license evidence, and review warnings; not a legal unlicensed determination.","returns_ja":"対象範囲、鮮度、法人照合、免許根拠、確認警告を返します。無登録の法的判断ではありません。","keywords":["FSA license","regulated entity","金融庁","免許確認"]},"x-price-usd":"$0.03","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402"}},"/v1/invoices/validate-jp-pint":{"post":{"summary":"Validate JP PINT Invoice XML","operationId":"validate_jp_pint_v1_invoices_validate_jp_pint_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JPPintValidateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JPPintValidateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"JP PINT Invoice Trust Validation","x-agent-use":"Validate JP PINT 1.1.3 Invoice XML against pinned offline OASIS UBL 2.1 XSD and OpenPeppol Schematron, with optional NTA issuer evidence. document_valid is the official XSD/Schematron result; decision and trusted are separate registry-aware fields. It is an evidence check, not tax/legal or Peppol conformance certification. / 固定したOASIS UBL 2.1 XSDとOpenPeppol SchematronでJP PINT 1.1.3請求書XMLを検証し、任意で国税庁発行者根拠を追加します。","x-agent-selection":{"use_when":"You need offline validation of a JP PINT 1.1.3 UBL Invoice before accounting or payment workflow acceptance.","use_when_ja":"会計処理や支払ワークフローに受け入れる前に、JP PINT 1.1.3 UBL請求書をオフライン検証したい場合。","returns":"Official document_valid from pinned OASIS UBL 2.1 XSD and OpenPeppol JP PINT 1.1.3 Schematron, plus separate decision/trusted fields and optional NTA registry evidence.","returns_ja":"固定したOASIS UBL 2.1 XSDとOpenPeppol JP PINT 1.1.3 Schematronによるdocument_valid、分離されたdecision/trusted、任意の国税庁登記根拠を返します。","keywords":["JP PINT","PINT Japan","UBL Invoice validation","Peppol invoice","JP PINT検証","電子請求書"]},"x-price-usd":"$0.02","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"],"description":"\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/v1/invoices/validate-jp-pint \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"xml\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?><Invoice xmlns=\\\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\\\" xmlns:cac=\\\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\\\" xmlns:cbc=\\\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\\\"><cbc:CustomizationID>urn:peppol:pint:billing-1@jp-1</cbc:CustomizationID><cbc:ProfileID>urn:peppol:bis:billing</cbc:ProfileID><cbc:ID>INV-0001</cbc:ID><cbc:IssueDate>2026-11-01</cbc:IssueDate><cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode><cbc:DocumentCurrencyCode>JPY</cbc:DocumentCurrencyCode><cac:InvoicePeriod><cbc:StartDate>2026-10-01</cbc:StartDate><cbc:EndDate>2026-10-31</cbc:EndDate></cac:InvoicePeriod><cac:AccountingSupplierParty><cac:Party><cbc:EndpointID schemeID=\\\"0188\\\">1234567890123</cbc:EndpointID><cac:PostalAddress><cac:Country><cbc:IdentificationCode>JP</cbc:IdentificationCode></cac:Country></cac:PostalAddress><cac:PartyTaxScheme><cbc:CompanyID>T1234567890123</cbc:CompanyID><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:PartyTaxScheme><cac:PartyLegalEntity><cbc:RegistrationName>サンプル商事株式会社</cbc:RegistrationName></cac:PartyLegalEntity></cac:Party></cac:AccountingSupplierParty><cac:AccountingCustomerParty><cac:Party><cbc:EndpointID schemeID=\\\"0188\\\">3210987654321</cbc:EndpointID><cac:PostalAddress><cac:Country><cbc:IdentificationCode>JP</cbc:IdentificationCode></cac:Country></cac:PostalAddress><cac:PartyLegalEntity><cbc:RegistrationName>株式会社サンプル購買</cbc:RegistrationName></cac:PartyLegalEntity></cac:Party></cac:AccountingCustomerParty><cac:TaxTotal><cbc:TaxAmount currencyID=\\\"JPY\\\">1000</cbc:TaxAmount><cac:TaxSubtotal><cbc:TaxableAmount currencyID=\\\"JPY\\\">10000</cbc:TaxableAmount><cbc:TaxAmount currencyID=\\\"JPY\\\">1000</cbc:TaxAmount><cac:TaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>10</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:TaxCategory></cac:TaxSubtotal></cac:TaxTotal><cac:LegalMonetaryTotal><cbc:LineExtensionAmount currencyID=\\\"JPY\\\">10000</cbc:LineExtensionAmount><cbc:TaxExclusiveAmount currencyID=\\\"JPY\\\">10000</cbc:TaxExclusiveAmount><cbc:TaxInclusiveAmount currencyID=\\\"JPY\\\">11000</cbc:TaxInclusiveAmount><cbc:PayableAmount currencyID=\\\"JPY\\\">11000</cbc:PayableAmount></cac:LegalMonetaryTotal><cac:InvoiceLine><cbc:ID>1</cbc:ID><cbc:InvoicedQuantity unitCode=\\\"H87\\\">1</cbc:InvoicedQuantity><cbc:LineExtensionAmount currencyID=\\\"JPY\\\">10000</cbc:LineExtensionAmount><cac:Item><cbc:Name>Consulting service</cbc:Name><cac:ClassifiedTaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>10</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:ClassifiedTaxCategory></cac:Item><cac:Price><cbc:PriceAmount currencyID=\\\"JPY\\\">10000</cbc:PriceAmount></cac:Price></cac:InvoiceLine></Invoice>\", \"registry_enhance\": false}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/v1/invoices/validate-jp-pint\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"xml\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?><Invoice xmlns=\\\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\\\" xmlns:cac=\\\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\\\" xmlns:cbc=\\\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\\\"><cbc:CustomizationID>urn:peppol:pint:billing-1@jp-1</cbc:CustomizationID><cbc:ProfileID>urn:peppol:bis:billing</cbc:ProfileID><cbc:ID>INV-0001</cbc:ID><cbc:IssueDate>2026-11-01</cbc:IssueDate><cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode><cbc:DocumentCurrencyCode>JPY</cbc:DocumentCurrencyCode><cac:InvoicePeriod><cbc:StartDate>2026-10-01</cbc:StartDate><cbc:EndDate>2026-10-31</cbc:EndDate></cac:InvoicePeriod><cac:AccountingSupplierParty><cac:Party><cbc:EndpointID schemeID=\\\"0188\\\">1234567890123</cbc:EndpointID><cac:PostalAddress><cac:Country><cbc:IdentificationCode>JP</cbc:IdentificationCode></cac:Country></cac:PostalAddress><cac:PartyTaxScheme><cbc:CompanyID>T1234567890123</cbc:CompanyID><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:PartyTaxScheme><cac:PartyLegalEntity><cbc:RegistrationName>サンプル商事株式会社</cbc:RegistrationName></cac:PartyLegalEntity></cac:Party></cac:AccountingSupplierParty><cac:AccountingCustomerParty><cac:Party><cbc:EndpointID schemeID=\\\"0188\\\">3210987654321</cbc:EndpointID><cac:PostalAddress><cac:Country><cbc:IdentificationCode>JP</cbc:IdentificationCode></cac:Country></cac:PostalAddress><cac:PartyLegalEntity><cbc:RegistrationName>株式会社サンプル購買</cbc:RegistrationName></cac:PartyLegalEntity></cac:Party></cac:AccountingCustomerParty><cac:TaxTotal><cbc:TaxAmount currencyID=\\\"JPY\\\">1000</cbc:TaxAmount><cac:TaxSubtotal><cbc:TaxableAmount currencyID=\\\"JPY\\\">10000</cbc:TaxableAmount><cbc:TaxAmount currencyID=\\\"JPY\\\">1000</cbc:TaxAmount><cac:TaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>10</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:TaxCategory></cac:TaxSubtotal></cac:TaxTotal><cac:LegalMonetaryTotal><cbc:LineExtensionAmount currencyID=\\\"JPY\\\">10000</cbc:LineExtensionAmount><cbc:TaxExclusiveAmount currencyID=\\\"JPY\\\">10000</cbc:TaxExclusiveAmount><cbc:TaxInclusiveAmount currencyID=\\\"JPY\\\">11000</cbc:TaxInclusiveAmount><cbc:PayableAmount currencyID=\\\"JPY\\\">11000</cbc:PayableAmount></cac:LegalMonetaryTotal><cac:InvoiceLine><cbc:ID>1</cbc:ID><cbc:InvoicedQuantity unitCode=\\\"H87\\\">1</cbc:InvoicedQuantity><cbc:LineExtensionAmount currencyID=\\\"JPY\\\">10000</cbc:LineExtensionAmount><cac:Item><cbc:Name>Consulting service</cbc:Name><cac:ClassifiedTaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>10</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:ClassifiedTaxCategory></cac:Item><cac:Price><cbc:PriceAmount currencyID=\\\"JPY\\\">10000</cbc:PriceAmount></cac:Price></cac:InvoiceLine></Invoice>\", \"registry_enhance\": False},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/v1/invoices/validate-jp-pint\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"xml\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?><Invoice xmlns=\\\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\\\" xmlns:cac=\\\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\\\" xmlns:cbc=\\\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\\\"><cbc:CustomizationID>urn:peppol:pint:billing-1@jp-1</cbc:CustomizationID><cbc:ProfileID>urn:peppol:bis:billing</cbc:ProfileID><cbc:ID>INV-0001</cbc:ID><cbc:IssueDate>2026-11-01</cbc:IssueDate><cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode><cbc:DocumentCurrencyCode>JPY</cbc:DocumentCurrencyCode><cac:InvoicePeriod><cbc:StartDate>2026-10-01</cbc:StartDate><cbc:EndDate>2026-10-31</cbc:EndDate></cac:InvoicePeriod><cac:AccountingSupplierParty><cac:Party><cbc:EndpointID schemeID=\\\"0188\\\">1234567890123</cbc:EndpointID><cac:PostalAddress><cac:Country><cbc:IdentificationCode>JP</cbc:IdentificationCode></cac:Country></cac:PostalAddress><cac:PartyTaxScheme><cbc:CompanyID>T1234567890123</cbc:CompanyID><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:PartyTaxScheme><cac:PartyLegalEntity><cbc:RegistrationName>サンプル商事株式会社</cbc:RegistrationName></cac:PartyLegalEntity></cac:Party></cac:AccountingSupplierParty><cac:AccountingCustomerParty><cac:Party><cbc:EndpointID schemeID=\\\"0188\\\">3210987654321</cbc:EndpointID><cac:PostalAddress><cac:Country><cbc:IdentificationCode>JP</cbc:IdentificationCode></cac:Country></cac:PostalAddress><cac:PartyLegalEntity><cbc:RegistrationName>株式会社サンプル購買</cbc:RegistrationName></cac:PartyLegalEntity></cac:Party></cac:AccountingCustomerParty><cac:TaxTotal><cbc:TaxAmount currencyID=\\\"JPY\\\">1000</cbc:TaxAmount><cac:TaxSubtotal><cbc:TaxableAmount currencyID=\\\"JPY\\\">10000</cbc:TaxableAmount><cbc:TaxAmount currencyID=\\\"JPY\\\">1000</cbc:TaxAmount><cac:TaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>10</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:TaxCategory></cac:TaxSubtotal></cac:TaxTotal><cac:LegalMonetaryTotal><cbc:LineExtensionAmount currencyID=\\\"JPY\\\">10000</cbc:LineExtensionAmount><cbc:TaxExclusiveAmount currencyID=\\\"JPY\\\">10000</cbc:TaxExclusiveAmount><cbc:TaxInclusiveAmount currencyID=\\\"JPY\\\">11000</cbc:TaxInclusiveAmount><cbc:PayableAmount currencyID=\\\"JPY\\\">11000</cbc:PayableAmount></cac:LegalMonetaryTotal><cac:InvoiceLine><cbc:ID>1</cbc:ID><cbc:InvoicedQuantity unitCode=\\\"H87\\\">1</cbc:InvoicedQuantity><cbc:LineExtensionAmount currencyID=\\\"JPY\\\">10000</cbc:LineExtensionAmount><cac:Item><cbc:Name>Consulting service</cbc:Name><cac:ClassifiedTaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>10</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:ClassifiedTaxCategory></cac:Item><cac:Price><cbc:PriceAmount currencyID=\\\"JPY\\\">10000</cbc:PriceAmount></cac:Price></cac:InvoiceLine></Invoice>\", \"registry_enhance\": false}),\n});\nconsole.log(response.status, await response.json());\n```\n"}},"/v1/suppliers/resolve":{"post":{"summary":"Resolve Japanese Supplier Evidence","description":"Resolve a Japanese supplier using company-registry, qualified-invoice, and address evidence; it may optionally add projected gBizINFO v2 activity evidence in this response, not a standalone source or raw-response resale. This is a coverage-aware registry pre-check, not legal KYB, AML, sanctions, or identity clearance. / 法人登記、適格請求書、住所の根拠を組み合わせて日本の仕入先を確認します。対象範囲を明示した事前確認であり、法的KYB、AML、制裁、本人確認の判定ではありません。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/v1/suppliers/resolve \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"株式会社ABC\", \"registration_number\": \"T1013301046627\", \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/v1/suppliers/resolve\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"name\": \"株式会社ABC\", \"registration_number\": \"T1013301046627\", \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/v1/suppliers/resolve\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"name\": \"株式会社ABC\", \"registration_number\": \"T1013301046627\", \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"supplier_resolve_v1_suppliers_resolve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierResolveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupplierResolveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Supplier Evidence Resolve","x-agent-use":"Resolve a Japanese supplier using combined company, qualified-invoice, and address evidence. gBizINFO v2 may add projected activity evidence inside this response as optional enrichment; it is not a standalone data-resale endpoint. Returns coverage-aware checks without making a legal KYB conclusion. / 会社・適格請求書・住所の根拠を組み合わせて日本の仕入先を確認します。有効時はgBizINFO v2の活動根拠をレスポンス内に付加しますが、単独のデータ再販エンドポイントではありません。対象範囲を明示したチェックを返し、法的または完全なKYB判定は行いません。","x-agent-selection":{"use_when":"You need one coverage-aware supplier check combining company, qualified-invoice, and address evidence; optionally includes projected gBizINFO activity evidence when the internal feature flag is enabled.","use_when_ja":"会社、適格請求書、住所の根拠を組み合わせ、必要に応じて内部機能フラグでgBizINFO活動根拠も付加した、対象範囲を明示した仕入先確認を行う場合。","returns":"Independent evidence checks, source versions, and a resolved/ambiguous/not-found/insufficient-coverage status; optional gBizINFO is projected enrichment inside this response, not a standalone source or raw-response resale. Not a legal or KYB determination.","returns_ja":"個別の根拠チェック、ソース版、resolved/ambiguous/not-found/insufficient-coverage状態を返します。任意のgBizINFOはこのレスポンス内の加工済み補助根拠であり、単独ソースや原レスポンスの再販ではありません。法的判断やKYB判定ではありません。","keywords":["supplier resolution","vendor verification","仕入先確認","サプライヤー","T-number"]},"x-price-usd":"$0.01","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-invoice/verify":{"post":{"summary":"Verify Japanese Qualified Invoice Number","description":"Verify one Japanese qualified-invoice registration number against the NTA invoice registry; no OCR or issuer comparison is performed. / 日本の適格請求書発行事業者登録番号を国税庁のインボイスデータと照合します。OCRや発行者情報の比較は行いません。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-invoice/verify \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"registration_number\": \"T1013301046627\", \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-invoice/verify\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"registration_number\": \"T1013301046627\", \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-invoice/verify\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"registration_number\": \"T1013301046627\", \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_invoice_verify_jp_invoice_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan T-Number Verify","x-agent-use":"Japanese qualified-invoice verification. Keywords: T-number validation, qualified invoice, 適格請求書, インボイス登録番号, T番号. Validate a T+13 digit registration number against Japan's NTA registry and return registered, cancelled, or not-found status, corporate number, and dates. / T+13桁の適格請求書登録番号を国税庁データと照合し、登録・取消・未検出の状態、法人番号、日付を返します。","x-agent-selection":{"use_when":"You already have a Japanese T+13-digit qualified-invoice registration number.","use_when_ja":"日本のT+13桁インボイス登録番号が既にある場合。","returns":"NTA registration status, corporate number, registered name, and relevant dates.","returns_ja":"国税庁の登録状態、法人番号、登録名、関連日付を返します。","keywords":["T-number validation","qualified invoice","適格請求書","インボイス登録番号"]},"x-price-usd":"$0.01","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-invoice/extract":{"post":{"summary":"Extract and Validate Japanese Billing Invoice","description":"Extract a Japanese billing invoice and run deterministic local date, amount, tax, T-number, and completeness checks; no registry lookup is performed. / 日本語の請求書を抽出し、日付・金額・税額・T番号・必須項目を決定論的なローカルルールで検証します。法人データ照合は行いません。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-invoice/extract \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"text\": \"請求書 株式会社ABC 登録番号 T1013301046627 請求日 2026年8月15日 支払期日 2026年9月30日 合計110000円 消費税10000円\", \"fields\": [\"supplier_name\", \"registration_number\", \"invoice_date\", \"due_date\", \"total\", \"tax_amount\", \"payment_terms\"], \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-invoice/extract\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"text\": \"請求書 株式会社ABC 登録番号 T1013301046627 請求日 2026年8月15日 支払期日 2026年9月30日 合計110000円 消費税10000円\", \"fields\": [\"supplier_name\", \"registration_number\", \"invoice_date\", \"due_date\", \"total\", \"tax_amount\", \"payment_terms\"], \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-invoice/extract\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"text\": \"請求書 株式会社ABC 登録番号 T1013301046627 請求日 2026年8月15日 支払期日 2026年9月30日 合計110000円 消費税10000円\", \"fields\": [\"supplier_name\", \"registration_number\", \"invoice_date\", \"due_date\", \"total\", \"tax_amount\", \"payment_terms\"], \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_invoice_extract_jp_invoice_extract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceExtractRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Invoice OCR","x-agent-use":"Japanese billing-invoice OCR with deterministic local checks for dates, T-number format/checksum, tax, arithmetic, and required fields. Keywords: invoice OCR, 請求書OCR, 請求書, 適格請求書, インボイス, T番号. Supports text, HTTPS URL, Base64, PDF, HEIF, and TIFF. No registry lookup; use extract-and-verify for issuer comparison. / 日本語請求書OCR。日付、T番号形式・チェックサム、税額、金額整合性、必須項目をローカル検証します。text、HTTPS URL、Base64、PDF、HEIF、TIFFに対応。法人照合はextract-and-verifyを使用します。","x-agent-selection":{"use_when":"You need Japanese billing-invoice OCR and deterministic quality checks without registry lookup.","use_when_ja":"日本語の請求書をOCRし、法人照合なしで日付・金額・税額・T番号を検証したい場合。","returns":"OCR-derived invoice fields plus format, arithmetic, tax, completeness, and review status.","returns_ja":"OCR請求書項目に加え、形式・金額計算・税額・必須項目・確認状態を返します。","keywords":["invoice OCR","請求書OCR","請求書","適格請求書","インボイス","T番号"]},"x-price-usd":"$0.01","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-company/filings":{"get":{"tags":["Paid APIs — highest price first / 有料API（単価の高い順）"],"summary":"Search EDINET Filings","description":"Search covered EDINET filing metadata by corporate number, EDINET code, or security code and report index coverage. Raw files are not returned. / 法人番号、EDINETコード、証券コードから対象範囲内の提出書類メタデータを検索し、索引の対象範囲を返します。原本ファイルは返しません。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -G https://api.jpverify.com/jp-company/filings \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  --data-urlencode 'edinet_code=E00000' \\\n  --data-urlencode 'limit=20' \\\n  --data-urlencode 'response_language=en'\n```\n\n```python\nimport os, requests\n\nresponse = requests.get(\n    \"https://api.jpverify.com/jp-company/filings\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    params={\"edinet_code\": \"E00000\", \"limit\": 20, \"response_language\": \"en\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(`https://api.jpverify.com/jp-company/filings?${new URLSearchParams({\"edinet_code\": \"E00000\", \"limit\": 20, \"response_language\": \"en\"})}`, {\n  method: \"GET\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n  }\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"filings_jp_company_filings_get","parameters":[{"name":"corporate_number","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"}},{"name":"edinet_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edinet Code"}},{"name":"security_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Code"}},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date To"}},{"name":"doc_type_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Type Code"}},{"name":"form_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Form Code"}},{"name":"include_withdrawn","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Withdrawn"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"response_language","in":"query","required":false,"schema":{"type":"string","pattern":"^(en|ja|both)$","default":"en","title":"Response Language"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan EDINET Filing Search","x-agent-use":"Search EDINET filing metadata with official evidence references. / 公式根拠付きでEDINET提出書類を検索します。","x-agent-selection":{"use_when":"You need EDINET filing metadata for a Japanese company by corporate number, EDINET code, or security code.","use_when_ja":"法人番号、EDINETコード、証券コードから日本企業のEDINET提出書類を検索する場合。","returns":"Filing metadata, correction/withdrawal relationships, freshness, and official evidence references; raw files remain internal.","returns_ja":"提出書類メタデータ、訂正・撤回関係、鮮度、公式根拠を返します。原本ファイルは返しません。","keywords":["EDINET filings","Japan filings","提出書類","有価証券報告書"]},"x-price-usd":"$0.01","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402"}},"/jp-company/verify":{"post":{"summary":"Verify Japanese Company","description":"Verify a Japanese company by corporate number or Japanese name. / 法人番号または日本語の会社名で日本企業を検証します。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-company/verify \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"トヨタ自動車株式会社\", \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-company/verify\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"name\": \"トヨタ自動車株式会社\", \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-company/verify\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"name\": \"トヨタ自動車株式会社\", \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_company_verify_jp_company_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Company Verify","x-agent-use":"Japanese company verification. Keywords: company verification Japan, corporate number, 法人番号, 法人番号照合, 日本企業. Resolve a company name, 13-digit corporate number (法人番号), or address against Japan's NTA corporate registry; return active/closed status and match evidence. / 会社名、13桁の法人番号、住所を国税庁の法人番号公表データと照合し、活動状態と一致根拠を返します。","x-agent-selection":{"use_when":"You need a Japanese company or corporate-number lookup.","use_when_ja":"日本企業または法人番号を検索・照合したい場合。","returns":"Corporate number, registered legal name/address, active or closed status, and match evidence.","returns_ja":"法人番号、登記上の法人名・住所、活動状態、一致根拠を返します。","keywords":["company verification Japan","corporate number","法人番号","法人番号照合"]},"x-price-usd":"$0.005","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-address/normalize":{"post":{"summary":"Normalize Japanese Address","description":"Normalize a Japanese address with or without a postal code; missing postal codes are not inferred. / 郵便番号の有無にかかわらず日本住所を正規化・検証しますが、未入力の郵便番号は自動補完しません。\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-address/normalize \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"address\": \"東京都新宿区西新宿2丁目8番1号\", \"response_language\": \"both\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-address/normalize\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"address\": \"東京都新宿区西新宿2丁目8番1号\", \"response_language\": \"both\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-address/normalize\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"address\": \"東京都新宿区西新宿2丁目8番1号\", \"response_language\": \"both\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_address_normalize_jp_address_normalize_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressNormalizeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Address Normalize","x-agent-use":"Japanese address normalization (日本住所正規化, 住所標準化). Parse an address with or without a postal code into prefecture/city/components and match it against local address data. A unique truncated town prefix may be recovered; ambiguous prefixes are not guessed. A missing postal code is not inferred; use postal-lookup. / 郵便番号の有無にかかわらず日本住所を解析・照合します。一意な町名の欠損は補完し、曖昧な場合は推測しません。郵便番号は補完しないため、逆引きはpostal-lookupを使用します。","x-agent-selection":{"use_when":"You need Japanese address normalization or standardization, whether or not the input contains a postal code.","use_when_ja":"入力に郵便番号があってもなくても、日本住所を正規化・標準化したい場合。","returns":"Normalized prefecture/city/town/chome/block/lot/house components, parser confidence, match hierarchy, geocoder evidence, and postal-code evidence when a postal code is supplied. It does not infer a missing postal code.","returns_ja":"都道府県・市区町村・町名・丁目・番地・号などの正規化項目、解析信頼度、照合階層、地理コード根拠を返します。郵便番号を入力した場合のみ郵便番号根拠を返し、未入力の郵便番号は推定しません。","keywords":["Japanese address normalization","Japan address standardization","日本住所正規化","住所標準化","postal code optional","postal code missing","住所郵便番号なし"]},"x-price-usd":"$0.005","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-address/parse":{"post":{"summary":"Parse Japanese Address","description":"Parse a Japanese address without postal or geocoder evidence.\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-address/parse \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"address\": \"東京都千代田区千代田1丁目1番1号\", \"response_language\": \"ja\"}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-address/parse\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"address\": \"東京都千代田区千代田1丁目1番1号\", \"response_language\": \"ja\"},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-address/parse\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"address\": \"東京都千代田区千代田1丁目1番1号\", \"response_language\": \"ja\"}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_address_parse_jp_address_parse_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressParseRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressParseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Address Parse","x-agent-use":"Japanese address parser and component extraction. Keywords: Japanese address parser, address components, chome, block, lot, house, 丁目, 番地, 号. Parse a Japanese address into components without returning postal validation or geocoding; local postal prefix evidence may safely recover a unique town or report ambiguity. / 日本住所を構造化します。郵便番号の検証結果・ジオコーディングは返しませんが、町域の一意な前方一致による補完・曖昧性判定のためローカル郵便データを内部参照する場合があります。","x-agent-selection":{"use_when":"You need Japanese address components such as prefecture, city, town, chome, block, lot, or house without postal lookup or geocoding.","use_when_ja":"郵便番号照合やジオコーディングなしで、日本住所の構成要素だけが必要な場合。","returns":"Parser-only components, normalized value, chome/block/lot/house fields, normalization changes, unparsed fragments, parser status, and parser confidence. Postal and geocoder evidence are not returned.","returns_ja":"住所構成要素、正規化値、丁目・番地・号、正規化変更、未解析部分、解析状態、解析信頼度を返します。郵便・地理コード根拠は返しません。","keywords":["Japanese address parser","日本住所解析","address components","chome","block","lot","house","丁目","番地","号"]},"x-price-usd":"$0.005","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-address/geocode":{"post":{"summary":"Geocode Japanese Address","description":"Return provider-neutral local geocoder candidates.\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-address/geocode \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"address\": \"東京都千代田区千代田1丁目1番1号\", \"max_candidates\": 3}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-address/geocode\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"address\": \"東京都千代田区千代田1丁目1番1号\", \"max_candidates\": 3},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-address/geocode\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"address\": \"東京都千代田区千代田1丁目1番1号\", \"max_candidates\": 3}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_address_geocode_jp_address_geocode_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeocodeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeocodeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Address Geocode","x-agent-use":"Japanese forward geocoding from an address to coordinates. Keywords: Japan geocoder, address to coordinates, building-level geocode, Jageocoder, chome, block, lot, house. Returns provider-neutral local candidates, coordinates, address IDs, hierarchy levels, unmatched tails, and partial-match warnings. Jageocoder level 5/6 is oaza/aza, level 7 is block, and level 8 is a building or house node when present in the dictionary; town-level evidence is not a door-number or coordinate accuracy claim.","x-agent-selection":{"use_when":"You need Japanese forward-geocoding candidates, coordinates, address IDs, or hierarchy levels. The required hierarchy is inferred from the input.","use_when_ja":"日本住所を座標に変換し、候補、住所ID、階層レベルが必要な場合。","returns":"Provider-neutral Jageocoder candidates with normalized address, coordinates, address ID, match level, granularity, confidence, reasons, unmatched tails, and dictionary status. Level 5/6 is oaza/aza, 7 is block, and 8 is building or house node when covered. City-level or town-prefix candidates remain partial; town-level results are not door-number or coordinate accuracy claims.","returns_ja":"正規化住所、座標、住所ID、照合レベル、粒度、信頼度、理由、未照合末尾、辞書状態を含むJageocoder候補を返します。5/6=大字・字、7=街区、8=住居番号です。市町村候補や町域の部分一致はpartialのままで、町域一致を門牌・座標精度とは表示しません。","keywords":["Japanese geocoding","Japan geocoder","forward geocoding","address to coordinates","building-level geocode","日本住所ジオコーディング","Jageocoder","丁目","番地","号"]},"x-price-usd":"$0.005","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-address/validate":{"post":{"summary":"Validate Japanese Address","description":"Apply one validation policy to parser, postal, and geocoder evidence.\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-address/validate \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"address\": \"東京都千代田区千代田1丁目1番1号\", \"required_level\": 8, \"strict\": false}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-address/validate\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"address\": \"東京都千代田区千代田1丁目1番1号\", \"required_level\": 8, \"strict\": False},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-address/validate\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"address\": \"東京都千代田区千代田1丁目1番1号\", \"required_level\": 8, \"strict\": false}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_address_validate_jp_address_validate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAddressRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAddressResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Address Validate","x-agent-use":"Japanese address validation and quality decision. Keywords: Japanese address validation, address conflict, address quality, partial match, 日本住所検証. Validate parser, postal, and geocoder evidence using one address policy, returning exact, partial, ambiguous, conflict, or unverified status with the accepted hierarchy and reasons. / 住所解析・郵便番号・ジオコーディングの根拠を統一ルールで照合し、完全一致・部分一致・曖昧・矛盾・未検証の判定を、採用した住所階層と理由とともに返します。","x-agent-selection":{"use_when":"You need one evidence-based Japanese address quality decision combining parsed address, postal evidence, and geocoder evidence.","use_when_ja":"解析住所、郵便番号根拠、ジオコーダー根拠を統一ルールで判定したい場合。","returns":"Exact, partial, ambiguous, conflict, or unverified status with accepted hierarchy, confidence signals, validation scope, and reasons.","returns_ja":"完全一致、部分一致、候補不一意、矛盾、未検証の状態に加え、採用階層、信頼度、判定範囲、理由を返します。","keywords":["Japanese address validation","address quality","address conflict","partial match","日本住所検証","住所品質"]},"x-price-usd":"$0.005","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/jp-address/postal-lookup":{"post":{"summary":"Look Up Japanese Postal Code","description":"Look up Japan Post postal evidence, optionally via the internal v2 source.\n\n#### Example / 呼び出し例\n\n```bash\ncurl -X POST https://api.jpverify.com/jp-address/postal-lookup \\\n  -H \"Authorization: Bearer $JPVERIFY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"postal_code\": \"100-0001\", \"max_results\": 10}'\n```\n\n```python\nimport os, requests\n\nresponse = requests.post(\n    \"https://api.jpverify.com/jp-address/postal-lookup\",\n    headers={\"Authorization\": f\"Bearer {os.environ['JPVERIFY_API_KEY']}\"},\n    json={\"postal_code\": \"100-0001\", \"max_results\": 10},\n    timeout=60,\n)\nprint(response.status_code, response.json())\n```\n\n```javascript\nconst response = await fetch(\"https://api.jpverify.com/jp-address/postal-lookup\", {\n  method: \"POST\",\n  headers: {\n    \"Authorization\": `Bearer ${process.env.JPVERIFY_API_KEY}`,\n    \"Content-Type\": \"application/json\",\n  },\n  body: JSON.stringify({\"postal_code\": \"100-0001\", \"max_results\": 10}),\n});\nconsole.log(response.status, await response.json());\n```\n","operationId":"jp_address_postal_lookup_jp_address_postal_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalLookupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostalLookupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"401":{"description":"`invalid_api_key`: the key is missing, malformed, unknown or revoked."},"402":{"description":"`insufficient_credits`: the balance is lower than the price. Nothing was charged; the body includes `top_up_url`."}},"x-service-name":"Japan Postal Lookup","x-agent-use":"Japanese postal-code lookup and reverse lookup. Keywords: Japanese postal lookup, Japan Post postal code, postal code reverse lookup, 日本郵便番号検索. Use a postal code or prefecture/city/ward/town components against the local Japan Post snapshot. / 郵便番号、または都道府県・市区町村・区・町域を指定し、ローカルの日本郵便データで郵便番号を検索・逆引きします。","x-agent-selection":{"use_when":"You need a Japan Post postal-code lookup or reverse lookup from a postal code or administrative address.","use_when_ja":"郵便番号または行政区・町名から日本の郵便番号を逆引きしたい場合。","returns":"Japan Post local-snapshot matches with postal code, prefecture, city, town, kana, confidence, source, data version, and candidate count.","returns_ja":"Japan Postローカルデータの郵便番号、都道府県、市区町村、町名、かな、信頼度、出典、データ版、候補数を返します。","keywords":["Japanese postal lookup","Japan Post postal code","postal code reverse lookup","日本郵便番号検索","郵便番号逆引き"]},"x-price-usd":"$0.001","security":[{"apiKeyBearer":[]},{"apiKeyHeader":[]}],"x-billing":"prepaid credits (API key); same price as x402","tags":["Paid APIs — highest price first / 有料API（単価の高い順）"]}},"/health":{"get":{"summary":"Health","description":"Return service, network, dependency, database freshness, and priority-catalog health. This endpoint is free and does not require payment. / サービス、ネットワーク、依存関係、データ鮮度、優先カタログの状態を返します。無料で支払いは不要です。","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}},"security":[]}},"/v1/jp-official-data/sources":{"get":{"tags":["Japan official data"],"summary":"Sources","description":"List official-data sources and public dataset metadata. Requires the admin bearer token. / 公式データソースと公開データセットのメタデータを一覧します。管理者Bearerトークンが必要です。","operationId":"sources_v1_jp_official_data_sources_get","parameters":[{"name":"access_mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Access Mode"}},{"name":"automation_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Automation Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"adminBearer":[]}]}},"/v1/jp-official-data/sources/{source_id}":{"get":{"tags":["Japan official data"],"summary":"Source Detail","description":"Return one official-data source and its dataset metadata. Requires the admin bearer token. / 公式データソースとデータセットのメタデータを返します。管理者Bearerトークンが必要です。","operationId":"source_detail_v1_jp_official_data_sources__source_id__get","parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","title":"Source Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"adminBearer":[]}]}},"/v1/jp-official-data/downloads":{"post":{"tags":["Japan official data"],"summary":"Create Download","description":"Start an authenticated official-data download and quality-gate run. / 認証済みの公式データ取得と品質ゲート実行を開始します。","operationId":"create_download_v1_jp_official_data_downloads_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"adminBearer":[]}]}},"/v1/jp-official-data/downloads/{run_id}":{"get":{"tags":["Japan official data"],"summary":"Get Download","description":"Read the status and quality result of one official-data download run. Requires the admin bearer token. / 公式データ取得実行の状態と品質結果を返します。管理者Bearerトークンが必要です。","operationId":"get_download_v1_jp_official_data_downloads__run_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"adminBearer":[]}]}},"/v1/jp-official-data/artifacts":{"get":{"tags":["Japan official data"],"summary":"Artifacts","description":"List authenticated official-data artifacts and evidence metadata. / 認証済み公式データ成果物と根拠メタデータを一覧します。","operationId":"artifacts_v1_jp_official_data_artifacts_get","parameters":[{"name":"source_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id"}},{"name":"dataset_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Id"}},{"name":"effective_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Effective From"}},{"name":"effective_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Effective To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"adminBearer":[]}]}},"/v1/jp-official-data/artifacts/register":{"post":{"tags":["Japan official data"],"summary":"Register","description":"Register an authenticated official-data artifact after upload and validation. / アップロード後に検証済み公式データ成果物を登録します。","operationId":"register_v1_jp_official_data_artifacts_register_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_register_v1_jp_official_data_artifacts_register_post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"adminBearer":[]}]}}},"components":{"schemas":{"AddressNormalizeRequest":{"properties":{"address":{"type":"string","maxLength":500,"minLength":1,"title":"Address","description":"Japanese address to normalize, with or without a postal code. / 正規化する日本の住所（郵便番号の有無は問いません）。","examples":["東京都新宿区西新宿2丁目8番1号"]},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both","examples":["both"]}},"additionalProperties":false,"type":"object","required":["address"],"title":"AddressNormalizeRequest"},"AddressParseRequest":{"properties":{"address":{"type":"string","maxLength":500,"minLength":1,"title":"Address","examples":["東京都千代田区千代田1丁目1番1号"]},"postal_code":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Postal Code"},"response_language":{"type":"string","enum":["ja","both"],"title":"Response Language","default":"ja","examples":["ja"]},"parser_profile":{"type":"string","enum":["standard","strict"],"title":"Parser Profile","default":"standard"}},"additionalProperties":false,"type":"object","required":["address"],"title":"AddressParseRequest"},"AddressParseResponse":{"properties":{"original":{"type":"string","title":"Original"},"normalized":{"type":"string","title":"Normalized"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prefecture"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"ward":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ward"},"town":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Town"},"chome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chome"},"block":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Block"},"lot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lot"},"house":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"House"},"building":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Building"},"floor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Floor"},"room":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Room"},"other":{"items":{"type":"string"},"type":"array","title":"Other"},"changes":{"items":{"type":"string"},"type":"array","title":"Changes"},"unparsed":{"items":{"type":"string"},"type":"array","title":"Unparsed"},"town_recovery":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Town Recovery"},"requested_level":{"type":"integer","title":"Requested Level","default":0},"parsed_level":{"type":"integer","title":"Parsed Level","default":0},"verified_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Verified Level"},"precision_satisfied":{"type":"boolean","title":"Precision Satisfied","default":false},"granularity":{"type":"string","title":"Granularity","default":"none"},"parse_status":{"type":"string","enum":["parsed","partial","unparsed"],"title":"Parse Status","default":"unparsed"},"parse_confidence":{"type":"number","title":"Parse Confidence","default":0.0},"parser_version":{"type":"string","title":"Parser Version","default":"jp-address-parser.v1"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"response_language":{"type":"string","enum":["ja","both"],"title":"Response Language","default":"ja"}},"type":"object","required":["original","normalized"],"title":"AddressParseResponse"},"AddressResponse":{"properties":{"normalized":{"type":"string","title":"Normalized"},"normalized_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized En"},"normalized_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized En Source"},"normalized_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized En Confidence"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prefecture"},"county":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"County"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"ward":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ward"},"town":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Town"},"chome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chome"},"block":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Block"},"lot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lot"},"house":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"House"},"building":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Building"},"floor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Floor"},"room":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Room"},"other":{"items":{"type":"string"},"type":"array","title":"Other"},"changes":{"items":{"type":"string"},"type":"array","title":"Changes"},"unparsed":{"items":{"type":"string"},"type":"array","title":"Unparsed"},"town_recovery":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Town Recovery"},"match_status":{"type":"string","title":"Match Status","default":"unverified"},"match_level":{"type":"integer","title":"Match Level","default":0},"requested_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Requested Level"},"parsed_level":{"type":"integer","title":"Parsed Level","default":0},"verified_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Verified Level"},"precision_satisfied":{"type":"boolean","title":"Precision Satisfied","default":false},"granularity":{"type":"string","title":"Granularity","default":"none"},"candidate_count":{"type":"integer","title":"Candidate Count","default":0},"candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Candidates"},"matched":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched"},"upstream_matched":{"items":{"type":"string"},"type":"array","title":"Upstream Matched"},"unmatched_tail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unmatched Tail"},"address_id":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"null"}],"title":"Address Id"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"geocode_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Geocode Level"},"geocoder_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geocoder Status"},"geocode_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geocode Source"},"dictionary_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dictionary Version"},"dictionary_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dictionary Source"},"parse_confidence":{"type":"number","title":"Parse Confidence"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"postal_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Postal Confidence"},"geographic_match_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Geographic Match Confidence"},"postal_code_match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Postal Code Match"},"address_validated":{"type":"boolean","title":"Address Validated","default":false},"validation_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validation Source"},"validation_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validation Scope"},"source":{"type":"string","title":"Source"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"},"localized":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Localized"}},"type":"object","required":["normalized","parse_confidence","source"],"title":"AddressResponse"},"ArtifactListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ArtifactResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"ArtifactListResponse"},"ArtifactResponse":{"properties":{"artifact_id":{"type":"string","title":"Artifact Id"},"source_id":{"type":"string","title":"Source Id"},"dataset_id":{"type":"string","title":"Dataset Id"},"sha256":{"type":"string","title":"Sha256"},"original_filename":{"type":"string","title":"Original Filename"},"media_type":{"type":"string","title":"Media Type"},"format":{"type":"string","title":"Format"},"byte_size":{"type":"integer","title":"Byte Size"},"record_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Record Count"},"encoding":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encoding"},"official_resource_url":{"type":"string","title":"Official Resource Url"},"official_published_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Official Published At"},"effective_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Effective Date"},"downloaded_at":{"type":"string","title":"Downloaded At"},"etag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Etag"},"last_modified":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Modified"},"terms_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Terms Url"},"license_code":{"type":"string","title":"License Code"},"redistribution_status":{"type":"string","title":"Redistribution Status"},"supersedes_artifact_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supersedes Artifact Id"},"validation_json":{"type":"string","title":"Validation Json"}},"type":"object","required":["artifact_id","source_id","dataset_id","sha256","original_filename","media_type","format","byte_size","official_resource_url","downloaded_at","license_code","redistribution_status","validation_json"],"title":"ArtifactResponse"},"BatchCreateRequest":{"properties":{"operation":{"type":"string","enum":["company_verify","invoice_verify","invoice_check","supplier_resolve","address_normalize"],"title":"Operation"},"items":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array","maxItems":1000,"minItems":1},{"type":"null"}],"title":"Items"},"csv_data":{"anyOf":[{"type":"string","maxLength":2000000},{"type":"null"}],"title":"Csv Data"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","default":"both"}},"additionalProperties":false,"type":"object","required":["operation"],"title":"BatchCreateRequest","description":"OpenAPI request model; operation-specific validation happens per item."},"Body_register_v1_jp_official_data_artifacts_register_post":{"properties":{"source_id":{"type":"string","title":"Source Id"},"dataset_id":{"type":"string","title":"Dataset Id"},"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"official_resource_url":{"type":"string","title":"Official Resource Url"},"effective_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Effective Date"},"official_published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Official Published At"},"expected_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Sha256"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["source_id","dataset_id","file","official_resource_url"],"title":"Body_register_v1_jp_official_data_artifacts_register_post"},"BusinessCardResponse":{"properties":{"card":{"$ref":"#/components/schemas/CardData"},"extraction":{"$ref":"#/components/schemas/CardExtraction"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"company":{"anyOf":[{"$ref":"#/components/schemas/CardCompanyEnrichment"},{"type":"null"}]},"format":{"type":"string","enum":["json","vcard"],"title":"Format","default":"json"},"vcard":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vcard"},"privacy":{"$ref":"#/components/schemas/CardPrivacy"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"}},"additionalProperties":true,"type":"object","required":["card","extraction","privacy"],"title":"BusinessCardResponse"},"CandidateResponse":{"properties":{"entity_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Name"},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"match_reasons":{"items":{"type":"string"},"type":"array","title":"Match Reasons"}},"additionalProperties":false,"type":"object","title":"CandidateResponse"},"CardAddress":{"properties":{"normalized":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized"},"normalized_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized En"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prefecture"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"parse_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Parse Confidence"},"en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"En Source"},"en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"En Confidence"}},"additionalProperties":true,"type":"object","title":"CardAddress"},"CardCompanyEnrichment":{"properties":{"match":{"$ref":"#/components/schemas/CardMatch"},"legal_entity":{"anyOf":[{"$ref":"#/components/schemas/CardLegalEntity"},{"type":"null"}]},"invoice":{"$ref":"#/components/schemas/CardInvoiceResult"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"data_freshness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Freshness"},"data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data As Of"}},"additionalProperties":true,"type":"object","required":["match","invoice"],"title":"CardCompanyEnrichment"},"CardContact":{"properties":{"emails":{"items":{"$ref":"#/components/schemas/CardEmail"},"type":"array","title":"Emails"},"phones":{"items":{"$ref":"#/components/schemas/CardPhone"},"type":"array","title":"Phones"},"websites":{"items":{"type":"string"},"type":"array","title":"Websites"}},"type":"object","title":"CardContact"},"CardData":{"properties":{"person":{"$ref":"#/components/schemas/CardPerson"},"organization":{"$ref":"#/components/schemas/CardOrganization"},"contact":{"$ref":"#/components/schemas/CardContact"},"address":{"$ref":"#/components/schemas/CardAddress"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"}},"additionalProperties":true,"type":"object","required":["person","organization","contact","address"],"title":"CardData"},"CardEmail":{"properties":{"value":{"type":"string","title":"Value"},"type":{"type":"string","title":"Type","default":"work"}},"type":"object","required":["value"],"title":"CardEmail"},"CardError":{"properties":{"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"},"message_ja":{"type":"string","title":"Message Ja"},"retryable":{"type":"boolean","title":"Retryable"}},"type":"object","required":["code","message","message_ja","retryable"],"title":"CardError"},"CardErrorResponse":{"properties":{"detail":{"additionalProperties":{"$ref":"#/components/schemas/CardError"},"type":"object","title":"Detail"}},"type":"object","required":["detail"],"title":"CardErrorResponse"},"CardExtractRequest":{"properties":{"front_image_base64":{"anyOf":[{"type":"string","maxLength":35000000,"minLength":1},{"type":"null"}],"title":"Front Image Base64","description":"Base64 image of the front side. / 名刺表面のBase64画像。"},"back_image_base64":{"anyOf":[{"type":"string","maxLength":35000000,"minLength":1},{"type":"null"}],"title":"Back Image Base64","description":"Optional Base64 image of the back side. / 名刺裏面のBase64画像（任意）。"},"front_image_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Front Image Url","description":"HTTPS URL of the front image of the business card. / 名刺表面画像のHTTPS URL。","examples":["https://www.jpverify.com/samples/business-card-front.png"]},"back_image_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Back Image Url","description":"Optional HTTPS URL of the back image of the business card. / 名刺裏面画像のHTTPS URL（任意）。","examples":["https://www.jpverify.com/samples/business-card-back.png"]},"mime_type":{"type":"string","maxLength":80,"title":"Mime Type","description":"Image MIME type, normally image/jpeg or image/png. / 画像MIMEタイプ。通常はimage/jpegまたはimage/png。","default":"image/jpeg"},"max_pages":{"type":"integer","maximum":1.0,"minimum":1.0,"title":"Max Pages","description":"Number of pages to read; business cards are single-page, so only 1 is accepted. / 読み取るページ数。名刺は1ページのため1のみ指定できます。","default":1},"output_format":{"type":"string","enum":["json","vcard"],"title":"Output Format","description":"The API always returns JSON; vcard additionally includes a vCard 4.0 string. / APIは常にJSONを返し、vcard指定時はvCard 4.0文字列を追加します。","default":"json","examples":["json"]},"include_raw_text":{"type":"boolean","title":"Include Raw Text","description":"Include OCR text only when explicitly requested. / 明示的に指定した場合のみOCRテキストを返します。","default":false,"examples":[false]},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja、en、またはboth。","default":"both","examples":["both"]}},"additionalProperties":false,"type":"object","title":"CardExtractRequest","anyOf":[{"required":["front_image_url"]},{"required":["front_image_base64"]},{"required":["back_image_url"]},{"required":["back_image_base64"]}]},"CardExtraction":{"properties":{"languages_detected":{"items":{"type":"string"},"type":"array","title":"Languages Detected"},"sides_processed":{"items":{"type":"string","enum":["front","back"]},"type":"array","title":"Sides Processed"},"merged":{"type":"boolean","title":"Merged","default":false},"model_output_validated":{"type":"boolean","title":"Model Output Validated","default":true},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"field_confidence":{"additionalProperties":{"type":"number"},"type":"object","title":"Field Confidence"},"field_sources":{"additionalProperties":{"$ref":"#/components/schemas/CardSourceInfo"},"type":"object","title":"Field Sources"},"field_status":{"additionalProperties":{"type":"string"},"type":"object","title":"Field Status"},"manual_review_required":{"type":"boolean","title":"Manual Review Required","default":false},"field_regions":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Field Regions","description":"Safe provenance summary without OCR text or image coordinates. / OCRテキスト・画像座標を含まない取得元概要。"},"conflicts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Conflicts"},"processing":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Processing"}},"additionalProperties":true,"type":"object","title":"CardExtraction"},"CardInvoiceResult":{"properties":{"registration_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Number"},"status":{"type":"string","title":"Status"},"verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verdict"},"format_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Format Valid"},"checksum_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Checksum Valid"},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"entity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity"},"qualified_invoice_registered":{"type":"boolean","title":"Qualified Invoice Registered","default":false},"verified":{"type":"boolean","title":"Verified","default":false},"registration_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Date"},"cancel_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cancel Date"},"data_freshness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Freshness"},"data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data As Of"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"additionalProperties":true,"type":"object","required":["status"],"title":"CardInvoiceResult"},"CardLegalEntity":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En"},"name_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Source"},"name_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Confidence"},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"address_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En"},"address_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Source"},"address_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Confidence"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prefecture"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"assignment_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assignment Date"},"close_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Close Date"}},"additionalProperties":true,"type":"object","title":"CardLegalEntity"},"CardMatch":{"properties":{"status":{"type":"string","title":"Status"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"confidence_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence Scope"},"name_match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Name Match"},"address_match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Address Match"},"address_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Status"},"possible_branch_or_office":{"type":"boolean","title":"Possible Branch Or Office","default":false},"candidate_count":{"type":"integer","title":"Candidate Count","default":0},"match_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Match Type"},"match_evidence":{"additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"type":"object","title":"Match Evidence"}},"additionalProperties":true,"type":"object","required":["status"],"title":"CardMatch"},"CardOrganization":{"properties":{"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"display_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name En"},"display_name_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name En Source"},"display_name_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name En Confidence"},"legal_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name"},"legal_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name En"},"legal_name_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name En Source"},"legal_name_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name En Confidence"},"brand_names":{"items":{"type":"string"},"type":"array","title":"Brand Names"},"group_names":{"items":{"type":"string"},"type":"array","title":"Group Names"},"name_type":{"type":"string","enum":["legal_and_brand","legal","brand_only","unknown"],"title":"Name Type","default":"unknown"}},"additionalProperties":true,"type":"object","title":"CardOrganization"},"CardPerson":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En"},"name_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Source"},"name_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Confidence"},"titles":{"items":{"type":"string"},"type":"array","title":"Titles"},"titles_en":{"items":{"type":"string"},"type":"array","title":"Titles En"},"departments":{"items":{"type":"string"},"type":"array","title":"Departments"},"departments_en":{"items":{"type":"string"},"type":"array","title":"Departments En"}},"additionalProperties":true,"type":"object","title":"CardPerson"},"CardPhone":{"properties":{"value":{"type":"string","title":"Value"},"international":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"International"},"type":{"type":"string","title":"Type","default":"unknown"}},"type":"object","required":["value"],"title":"CardPhone"},"CardPrivacy":{"properties":{"image_retention":{"type":"string","title":"Image Retention"},"raw_text_included":{"type":"boolean","title":"Raw Text Included","default":false},"raw_text_retention":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Text Retention"}},"type":"object","required":["image_retention"],"title":"CardPrivacy"},"CardSourceInfo":{"properties":{"side":{"type":"string","enum":["front","back","both","unknown"],"title":"Side"},"language":{"anyOf":[{"type":"string","enum":["ja","en","mixed"]},{"type":"null"}],"title":"Language"},"inferred":{"type":"boolean","title":"Inferred","default":false}},"additionalProperties":true,"type":"object","required":["side"],"title":"CardSourceInfo"},"CompanyBatchItem":{"properties":{"verified":{"type":"boolean","title":"Verified","default":false},"record_found":{"type":"boolean","title":"Record Found","default":false},"status":{"type":"string","title":"Status"},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"name_en_official":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Official"},"name_en_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Display"},"name_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Source"},"name_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Confidence"},"furigana":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Furigana"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"address_en_official":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Official"},"address_en_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Display"},"address_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Source"},"address_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Confidence"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prefecture"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"corporation_type_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporation Type Code"},"corporation_type_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporation Type En"},"assignment_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assignment Date"},"close_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Close Date"},"close_cause":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Close Cause"},"successor_corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Successor Corporate Number"},"matches_requested_address":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Matches Requested Address"},"address_match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Address Match"},"match_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Match Type"},"match_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Match Score"},"query_normalized":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query Normalized"},"candidate_count":{"type":"integer","title":"Candidate Count","default":0},"candidates_truncated":{"type":"boolean","title":"Candidates Truncated","default":false},"candidates":{"items":{"$ref":"#/components/schemas/CompanyCandidate"},"type":"array","title":"Candidates"},"risk_flags":{"items":{"type":"string"},"type":"array","title":"Risk Flags"},"report_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Version"},"verification_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Scope"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type"},"data_freshness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Freshness"},"data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data As Of"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evidence"},"status_label_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Label En"},"localized":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Localized"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"},"status_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Label"},"index":{"type":"integer","title":"Index","default":0},"error":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Error"},"retryable":{"type":"boolean","title":"Retryable","default":false}},"type":"object","required":["status"],"title":"CompanyBatchItem","description":"A company result with stable batch position and item failure metadata."},"CompanyBatchRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CompanyVerifyRequest"},"type":"array","maxItems":10,"minItems":1,"title":"Items","examples":[[{"corporate_number":"1180301018771"}]]},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both","examples":["both"]}},"additionalProperties":false,"type":"object","required":["items"],"title":"CompanyBatchRequest"},"CompanyBatchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/CompanyBatchItem"},"type":"array","title":"Results"},"count":{"type":"integer","title":"Count"},"max_batch_size":{"type":"integer","title":"Max Batch Size","default":10},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"}},"type":"object","required":["results","count"],"title":"CompanyBatchResponse"},"CompanyCandidate":{"properties":{"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"name_en_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Display"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"address_en_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Display"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"match_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Match Score"},"matches_requested_address":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Matches Requested Address"}},"type":"object","title":"CompanyCandidate"},"CompanyResponse":{"properties":{"verified":{"type":"boolean","title":"Verified","default":false},"record_found":{"type":"boolean","title":"Record Found","default":false},"status":{"type":"string","title":"Status"},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"name_en_official":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Official"},"name_en_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Display"},"name_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Source"},"name_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Confidence"},"furigana":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Furigana"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"address_en_official":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Official"},"address_en_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Display"},"address_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Source"},"address_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Confidence"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"prefecture":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prefecture"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"corporation_type_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporation Type Code"},"corporation_type_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporation Type En"},"assignment_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assignment Date"},"close_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Close Date"},"close_cause":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Close Cause"},"successor_corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Successor Corporate Number"},"matches_requested_address":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Matches Requested Address"},"address_match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Address Match"},"match_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Match Type"},"match_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Match Score"},"query_normalized":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query Normalized"},"candidate_count":{"type":"integer","title":"Candidate Count","default":0},"candidates_truncated":{"type":"boolean","title":"Candidates Truncated","default":false},"candidates":{"items":{"$ref":"#/components/schemas/CompanyCandidate"},"type":"array","title":"Candidates"},"risk_flags":{"items":{"type":"string"},"type":"array","title":"Risk Flags"},"report_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Version"},"verification_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Scope"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type"},"data_freshness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Freshness"},"data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data As Of"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evidence"},"status_label_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Label En"},"localized":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Localized"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"},"status_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Label"}},"type":"object","required":["status"],"title":"CompanyResponse"},"CompanyVerifyRequest":{"anyOf":[{"required":["name"]},{"required":["corporate_number"]}],"properties":{"name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Name","description":"Company name to resolve, in Japanese or English; at least one of name, corporate_number, or address is required. / 照合する会社名（日本語・英語）。name、corporate_number、addressのいずれかが必要です。","examples":["トヨタ自動車株式会社"]},"corporate_number":{"anyOf":[{"type":"string","pattern":"^[0-9]{13}$"},{"type":"null"}],"title":"Corporate Number","description":"13-digit Japanese corporate number (法人番号), digits only. / 13桁の法人番号（数字のみ）。"},"address":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Address","description":"Registered or business address in Japan, used to resolve or confirm the company. / 会社の所在地（日本）。照合または確認に使用します。"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both","examples":["both"]}},"additionalProperties":false,"type":"object","title":"CompanyVerifyRequest"},"CrossBorderEntityResolveRequest":{"properties":{"country_code":{"type":"string","enum":["JP","GB"],"title":"Country Code","examples":["GB"]},"name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Name"},"address":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Address"},"identifiers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object","maxProperties":8},{"type":"null"}],"title":"Identifiers","examples":[{"company_number":"00000006"}]},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both","examples":["both"]}},"additionalProperties":false,"type":"object","required":["country_code"],"title":"CrossBorderEntityResolveRequest","description":"Country-routed entity evidence input for the JP/GB launch scope.","anyOf":[{"required":["identifiers"]},{"required":["name"]}]},"CrossBorderEntityResolveResponse":{"properties":{"status":{"type":"string","enum":["resolved","ambiguous","not_found","insufficient_coverage"],"title":"Status"},"identity_status":{"anyOf":[{"type":"string","enum":["verified","ambiguous","not_found","insufficient_coverage"]},{"type":"null"}],"title":"Identity Status"},"registration_status":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Registration Status"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"checks":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Checks"},"source_versions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Source Versions"},"conflicts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Conflicts"},"country_code":{"type":"string","enum":["JP","GB"],"title":"Country Code","default":"JP"},"confidence_band":{"type":"string","enum":["high","medium","low"],"title":"Confidence Band","default":"low"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"},"source_freshness":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Source Freshness"},"coverage":{"additionalProperties":true,"type":"object","title":"Coverage"},"decision":{"type":"string","enum":["verified","likely_match","ambiguous","not_found_within_coverage","insufficient_coverage"],"title":"Decision","default":"insufficient_coverage"},"confidence_reasons":{"items":{"type":"string"},"type":"array","title":"Confidence Reasons"},"checked_at":{"type":"string","title":"Checked At"},"next_actions":{"items":{"type":"string"},"type":"array","title":"Next Actions"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"},"route":{"type":"string","title":"Route","default":"cross_border_entity_resolution.v1"}},"additionalProperties":false,"type":"object","required":["status","checked_at"],"title":"CrossBorderEntityResolveResponse","description":"Same safe evidence projection as supplier resolution, with route metadata."},"DownloadRequest":{"properties":{"source_id":{"type":"string","maxLength":120,"minLength":1,"title":"Source Id"},"dataset_id":{"type":"string","maxLength":120,"minLength":1,"title":"Dataset Id"},"parameters":{"additionalProperties":true,"type":"object","title":"Parameters"},"mode":{"type":"string","pattern":"^(if_changed|force|metadata_only)$","title":"Mode","default":"if_changed"},"expected_sha256":{"anyOf":[{"type":"string","maxLength":64,"minLength":64},{"type":"null"}],"title":"Expected Sha256"},"idempotency_key":{"type":"string","maxLength":128,"minLength":1,"title":"Idempotency Key"}},"additionalProperties":false,"type":"object","required":["source_id","dataset_id","idempotency_key"],"title":"DownloadRequest"},"ExpectedSupplier":{"properties":{"registration_number":{"anyOf":[{"type":"string","pattern":"^T[0-9]{13}$"},{"type":"null"}],"title":"Registration Number"},"corporate_number":{"anyOf":[{"type":"string","pattern":"^[0-9]{13}$"},{"type":"null"}],"title":"Corporate Number"}},"additionalProperties":false,"type":"object","title":"ExpectedSupplier"},"ExtractResult":{"properties":{"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"supplier_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Name"},"registration_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Number"},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"invoice_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Date"},"receipt_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Receipt Date"},"issue_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issue Date"},"due_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Due Date"},"invoice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Id"},"amount":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Amount"},"subtotal":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Subtotal"},"total":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Total"},"tax_amount":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Tax Amount"},"tax_rate":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Tax Rate"},"tax_breakdown":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tax Breakdown"},"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items"},"customer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Name"},"transaction_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction Time"},"payment_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method"},"tax_included":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Tax Included"},"payment_terms":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Terms"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"supplier_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Address"},"supplier_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Phone"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"phone_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone Number"},"receipt_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Receipt Number"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"vendor":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Vendor"},"invoice":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Invoice"},"amounts":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Amounts"},"processing":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Processing","description":"Stable processing metadata; engine is exposed as structured_ocr. / 安定した処理メタデータ。engineはstructured_ocrとして返します。"},"field_confidence":{"additionalProperties":{"type":"number"},"type":"object","title":"Field Confidence","description":"Per-field extraction confidence. / 項目ごとの抽出信頼度。"},"field_sources":{"additionalProperties":{"type":"string"},"type":"object","title":"Field Sources","description":"Per-field source such as OCR or parser. / 項目ごとの取得元（OCR・パーサーなど）。"},"field_status":{"additionalProperties":{"type":"string"},"type":"object","title":"Field Status","description":"Per-field final status such as ocr_only, format_valid, corroborated, or needs_review. / 項目ごとの最終状態。"},"manual_review_required":{"type":"boolean","title":"Manual Review Required","default":false},"field_regions":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Field Regions","description":"Optional image-region metadata when available. / 利用可能な場合の画像領域メタデータ。"},"validation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Validation","description":"Deterministic local validation results; registry lookup is not performed by plain invoice extract. / 決定論的なローカル検証結果。通常の請求書extractでは法人データ照合を行いません。"},"supplier_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Name En"},"supplier_name_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Name En Source"},"supplier_name_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Name En Confidence"},"supplier_address_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Address En"},"supplier_address_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Address En Source"},"supplier_address_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Address En Confidence"},"localized":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Localized"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"}},"additionalProperties":true,"type":"object","title":"ExtractResult"},"FilingEvidenceResponse":{"properties":{"source":{"type":"string","title":"Source"},"official_document_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Official Document Url"},"list_artifact_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"List Artifact Id"}},"additionalProperties":false,"type":"object","required":["source"],"title":"FilingEvidenceResponse"},"FilingQueryResponse":{"properties":{"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edinet Code"},"security_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Code"},"date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From"},"date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To"}},"additionalProperties":false,"type":"object","title":"FilingQueryResponse"},"FilingResponse":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"seq_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seq Number"},"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edinet Code"},"security_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Code"},"jcn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jcn"},"filer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Name"},"issuer_edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Edinet Code"},"subject_edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject Edinet Code"},"subsidiary_edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subsidiary Edinet Code"},"fund_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fund Code"},"ordinance_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ordinance Code"},"form_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Form Code"},"doc_type_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Type Code"},"period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Start"},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End"},"submit_datetime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Submit Datetime"},"ope_datetime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ope Datetime"},"doc_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Description"},"parent_doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Doc Id"},"withdrawal_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Withdrawal Status"},"doc_info_edit_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Info Edit Status"},"disclosure_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disclosure Status"},"legal_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Status"},"xbrl_flag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Xbrl Flag"},"pdf_flag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pdf Flag"},"attach_doc_flag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attach Doc Flag"},"english_doc_flag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"English Doc Flag"},"csv_flag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Csv Flag"},"current_report_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Report Reason"},"first_seen_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Seen At"},"last_seen_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Seen At"},"source_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Date"},"evidence":{"$ref":"#/components/schemas/FilingEvidenceResponse"}},"additionalProperties":false,"type":"object","required":["doc_id","evidence"],"title":"FilingResponse"},"FilingRiskSnapshotResponse":{"properties":{"decision":{"type":"string","enum":["available","not_found_within_coverage","insufficient_coverage"],"title":"Decision"},"entity":{"additionalProperties":true,"type":"object","title":"Entity"},"filings":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Filings"},"disclosure_signals":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Disclosure Signals"},"facts_summary":{"additionalProperties":true,"type":"object","title":"Facts Summary"},"source":{"type":"string","title":"Source"},"as_of":{"type":"string","title":"As Of"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"additionalProperties":false,"type":"object","required":["decision","source","as_of"],"title":"FilingRiskSnapshotResponse"},"FilingsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/FilingResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"query":{"$ref":"#/components/schemas/FilingQueryResponse"},"data_freshness":{"type":"string","title":"Data Freshness"},"last_successful_sync_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Successful Sync At"},"source":{"type":"string","title":"Source"},"evidence":{"additionalProperties":{"type":"string"},"type":"object","title":"Evidence"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"response_language":{"type":"string","title":"Response Language","default":"en"},"requested_coverage":{"additionalProperties":true,"type":"object","title":"Requested Coverage"},"index_coverage":{"additionalProperties":true,"type":"object","title":"Index Coverage"},"coverage_status":{"type":"string","title":"Coverage Status","default":"insufficient_coverage"},"missing_dates":{"items":{"type":"string"},"type":"array","title":"Missing Dates"}},"additionalProperties":false,"type":"object","required":["query","data_freshness","source","evidence"],"title":"FilingsResponse"},"GeocodeRequest":{"properties":{"address":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Address","examples":["東京都千代田区千代田1丁目1番1号"]},"components":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Components"},"postal_code":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Postal Code"},"max_candidates":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Max Candidates","default":3,"examples":[3]},"minimum_acceptable_level":{"anyOf":[{"type":"integer","maximum":8.0,"minimum":1.0},{"type":"null"}],"title":"Minimum Acceptable Level"},"provider":{"type":"string","enum":["auto","local_jageocoder"],"title":"Provider","default":"auto"}},"additionalProperties":false,"type":"object","title":"GeocodeRequest","oneOf":[{"required":["address"]},{"required":["components"]}]},"GeocodeResponse":{"properties":{"status":{"type":"string","enum":["matched","partial","ambiguous","not_found","unavailable","error"],"title":"Status"},"candidate_count":{"type":"integer","title":"Candidate Count","default":0},"candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Candidates"},"matched":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched"},"upstream_matched":{"items":{"type":"string"},"type":"array","title":"Upstream Matched"},"geocoder_status":{"type":"string","title":"Geocoder Status"},"dictionary_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dictionary Version"},"minimum_acceptable_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Minimum Acceptable Level"},"verified_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Verified Level"},"precision_satisfied":{"type":"boolean","title":"Precision Satisfied","default":false},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["status","geocoder_status"],"title":"GeocodeResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"network":{"type":"string","title":"Network"},"company_registry":{"type":"string","title":"Company Registry"},"company_data_source":{"type":"string","title":"Company Data Source"},"company_data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Data As Of"},"company_record_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Company Record Count"},"company_sync_status":{"type":"string","title":"Company Sync Status","default":"not_run"},"company_base_snapshot_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Base Snapshot Date"},"company_latest_diff_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Latest Diff Date"},"company_last_successful_sync":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Last Successful Sync"},"company_signature_verified":{"type":"boolean","title":"Company Signature Verified","default":false},"company_gap_detected":{"type":"boolean","title":"Company Gap Detected","default":false},"invoice_registry":{"type":"string","title":"Invoice Registry"},"invoice_data_source":{"type":"string","title":"Invoice Data Source"},"invoice_data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Data As Of"},"invoice_record_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Invoice Record Count"},"invoice_sync_status":{"type":"string","title":"Invoice Sync Status","default":"not_run"},"invoice_base_snapshot_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Base Snapshot Date"},"invoice_latest_diff_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Latest Diff Date"},"invoice_last_successful_sync":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Last Successful Sync"},"invoice_signature_verified":{"type":"boolean","title":"Invoice Signature Verified","default":false},"invoice_gap_detected":{"type":"boolean","title":"Invoice Gap Detected","default":false},"ollama_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ollama Model"},"ollama_max_concurrency":{"type":"integer","title":"Ollama Max Concurrency","default":1},"ollama_max_queue":{"type":"integer","title":"Ollama Max Queue","default":3},"ollama_active_requests":{"type":"integer","title":"Ollama Active Requests","default":0},"legacy_llm_enabled":{"type":"boolean","title":"Legacy Llm Enabled","default":false},"ocr_max_concurrency":{"type":"integer","title":"Ocr Max Concurrency","default":2},"ocr_max_queue":{"type":"integer","title":"Ocr Max Queue","default":6},"ocr_active_requests":{"type":"integer","title":"Ocr Active Requests","default":0},"ocr_max_image_edge":{"type":"integer","title":"Ocr Max Image Edge","default":2200},"ocr_engine":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ocr Engine"},"ocr_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ocr Model"},"ocr_engine_available":{"type":"boolean","title":"Ocr Engine Available","default":false},"japan_postal_master":{"type":"string","title":"Japan Postal Master","default":"unavailable"},"japan_postal_record_count":{"type":"integer","title":"Japan Postal Record Count","default":0},"japan_postal_data_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Japan Postal Data Path"},"jageocoder":{"type":"string","title":"Jageocoder","default":"disabled"},"jageocoder_enabled":{"type":"boolean","title":"Jageocoder Enabled","default":false},"jageocoder_dictionary_exists":{"type":"boolean","title":"Jageocoder Dictionary Exists","default":false},"jageocoder_dictionary_dir":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jageocoder Dictionary Dir"},"jageocoder_dictionary_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jageocoder Dictionary Version"},"jageocoder_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jageocoder Error"},"priority_data_status":{"type":"string","title":"Priority Data Status","default":"unavailable"},"priority_fsa_categories":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Priority Fsa Categories","default":[]},"priority_edinet":{"additionalProperties":true,"type":"object","title":"Priority Edinet","default":{}},"priority_data_warnings":{"items":{"type":"string"},"type":"array","title":"Priority Data Warnings","default":[]},"official_data_admin_status":{"type":"string","title":"Official Data Admin Status","default":"not_configured"},"audit_encryption":{"type":"string","title":"Audit Encryption","default":"unavailable"},"audit_encryption_key_source":{"type":"string","title":"Audit Encryption Key Source","default":"none"},"audit_encryption_config_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audit Encryption Config Error"},"audit_writer_status":{"type":"string","title":"Audit Writer Status","default":"disabled"},"audit_writer_queue_max":{"type":"integer","title":"Audit Writer Queue Max","default":64},"audit_writer_queue_max_bytes":{"type":"integer","title":"Audit Writer Queue Max Bytes","default":134217728},"en_alias_index":{"type":"string","title":"En Alias Index","default":"disabled"},"en_alias_built_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"En Alias Built At"},"en_alias_nta_data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"En Alias Nta Data As Of"},"en_alias_edinet_codelist_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"En Alias Edinet Codelist As Of"}},"type":"object","required":["status","service","network","company_registry","company_data_source","invoice_registry","invoice_data_source"],"title":"HealthResponse"},"InvoiceBatchItem":{"properties":{"registration_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Number"},"record_found":{"type":"boolean","title":"Record Found","default":false},"status":{"type":"string","title":"Status"},"status_label_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Label En"},"verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verdict"},"format_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Format Valid"},"checksum_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Checksum Valid"},"qualified_invoice_registered":{"type":"boolean","title":"Qualified Invoice Registered","default":false},"match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Match"},"verification_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Scope"},"entity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity"},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"registered_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Name"},"registered_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Name En"},"name_en_official":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Official"},"name_en_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Display"},"name_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Source"},"name_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Confidence"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"address_en_official":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Official"},"address_en_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Display"},"address_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Source"},"address_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Confidence"},"currency":{"type":"string","title":"Currency","default":"JPY"},"registration_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Date"},"update_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Update Date"},"disposal_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disposal Date"},"cancel_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cancel Date"},"expire_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expire Date"},"dataset_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Category"},"data_completeness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Completeness"},"data_freshness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Freshness"},"data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data As Of"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"verification_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Confidence"},"evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evidence"},"localized":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Localized"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"},"status_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Label"},"index":{"type":"integer","title":"Index","default":0},"error":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Error"},"retryable":{"type":"boolean","title":"Retryable","default":false}},"type":"object","required":["status"],"title":"InvoiceBatchItem","description":"An invoice result with stable batch position and item failure metadata."},"InvoiceBatchRequest":{"properties":{"registration_numbers":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Registration Numbers","examples":[["T1013301046627"]]},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both","examples":["both"]}},"additionalProperties":false,"type":"object","required":["registration_numbers"],"title":"InvoiceBatchRequest"},"InvoiceBatchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/InvoiceBatchItem"},"type":"array","title":"Results"},"count":{"type":"integer","title":"Count"},"max_batch_size":{"type":"integer","title":"Max Batch Size","default":10},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"}},"type":"object","required":["results","count"],"title":"InvoiceBatchResponse"},"InvoiceCheckRequest":{"properties":{"registration_number":{"type":"string","maxLength":32,"minLength":1,"title":"Registration Number","description":"Qualified-invoice registration number: T followed by 13 digits, e.g. T1013301046627. / 適格請求書発行事業者登録番号（T＋13桁）。","examples":["T1013301046627"]},"supplier_name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Supplier Name","description":"Issuer name as printed on the invoice, compared with the NTA registries. / 請求書に記載された発行者名。国税庁データと比較します。","examples":["株式会社ABC"]},"address":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Address","description":"Issuer address as printed on the invoice, compared with the registry address. / 請求書に記載された発行者住所。登記住所と比較します。"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both","examples":["both"]}},"additionalProperties":false,"type":"object","required":["registration_number"],"title":"InvoiceCheckRequest"},"InvoiceCheckResponse":{"properties":{"decision":{"type":"string","title":"Decision"},"decision_label_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decision Label En"},"verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verdict"},"registration_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Number"},"registration_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Status"},"registration_status_label_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Status Label En"},"format_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Format Valid"},"checksum_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Checksum Valid"},"qualified_invoice_registered":{"type":"boolean","title":"Qualified Invoice Registered","default":false},"record_found":{"type":"boolean","title":"Record Found","default":false},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"entity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity"},"legal_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name"},"registered_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Name"},"registered_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Name En"},"legal_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name En"},"legal_name_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name En Source"},"legal_name_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legal Name En Confidence"},"registered_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Address"},"registered_address_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Address En"},"registered_address_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Address En Source"},"registered_address_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Address En Confidence"},"supplier_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Name"},"supplier_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Name En"},"supplier_name_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Name En Source"},"supplier_name_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Name En Confidence"},"company_match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Company Match"},"address_match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Address Match"},"risk_flags":{"items":{"type":"string"},"type":"array","title":"Risk Flags"},"risk_labels_en":{"items":{"type":"string"},"type":"array","title":"Risk Labels En"},"currency":{"type":"string","title":"Currency","default":"JPY"},"data_freshness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Freshness"},"data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data As Of"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evidence"},"localized":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Localized"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"},"decision_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decision Label"},"registration_status_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Status Label"},"risk_labels":{"items":{"type":"string"},"type":"array","title":"Risk Labels"},"company":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Company"},"issuer_resolution":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Issuer Resolution"}},"type":"object","required":["decision"],"title":"InvoiceCheckResponse"},"InvoiceCounterpartyRequest":{"properties":{"vat_id":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Vat Id","description":"Known EU VAT ID including the country prefix, e.g. DE123456789; VIES does not support name search. / 国コード付きの既知のEU VAT ID。VIESは名称検索に対応しません。","examples":["DE123456789"]},"participant_id":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Participant Id","description":"Peppol participant identifier in scheme::value form, e.g. iso6523-actorid-upis::0088:123456789. / scheme::value形式のPeppol参加者ID。","examples":["iso6523-actorid-upis::0088:123456789"]},"name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Name","description":"Expected legal name, compared with the name VIES returns. / 想定する法人名。VIESが返す名称と比較します。"},"country_code":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"title":"Country Code","description":"Optional two-letter country code of the counterparty. / 取引先の2文字国コード（任意）。"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both","examples":["both"]}},"additionalProperties":false,"type":"object","title":"InvoiceCounterpartyRequest","description":"Cross-border invoice counterparty checks; raw provider payloads are never returned."},"InvoiceCounterpartyResponse":{"properties":{"decision":{"type":"string","enum":["verified","likely_match","not_found_within_coverage","insufficient_coverage","manual_review"],"title":"Decision"},"vat":{"additionalProperties":true,"type":"object","title":"Vat"},"entity_match":{"additionalProperties":true,"type":"object","title":"Entity Match"},"peppol":{"additionalProperties":true,"type":"object","title":"Peppol"},"checks":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Checks"},"conflicts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Conflicts"},"checked_at":{"type":"string","title":"Checked At"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"}},"additionalProperties":false,"type":"object","required":["decision","checked_at"],"title":"InvoiceCounterpartyResponse"},"InvoiceDocumentFields":{"properties":{"registration_number":{"anyOf":[{"type":"string","pattern":"^T[0-9]{13}$"},{"type":"null"}],"title":"Registration Number"},"issuer_name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Issuer Name"},"issuer_address":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Issuer Address"},"invoice_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Date"}},"additionalProperties":false,"type":"object","title":"InvoiceDocumentFields","examples":[{"registration_number":"T9000000000000"}]},"InvoiceExtractRequest":{"properties":{"text":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Text","description":"Already available document text. Choose exactly one primary source: text, image_base64, or file_url. / 既に取得済みの文書テキスト。主入力としてtext、image_base64、file_urlのいずれか1つを指定します。","examples":["請求書 株式会社ABC 登録番号 T1013301046627 請求日 2026年8月15日 支払期日 2026年9月30日 合計110000円 消費税10000円"]},"image_base64":{"anyOf":[{"type":"string","maxLength":35000000,"minLength":1},{"type":"null"}],"title":"Image Base64","description":"Base64-encoded image, PDF, HEIF, or TIFF file. / 画像、PDF、HEIF、TIFFファイルのBase64文字列。"},"file_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"File Url","description":"HTTPS URL for an image or document file. / 画像・文書ファイルのHTTPS URL。"},"mime_type":{"type":"string","maxLength":80,"title":"Mime Type","description":"Input MIME type; inferred when omitted. / 入力MIMEタイプ。未指定時は推定します。","default":"image/jpeg"},"max_pages":{"type":"integer","maximum":2.0,"minimum":1.0,"title":"Max Pages","description":"Maximum PDF pages to process (1-2). / 処理するPDF最大ページ数（1〜2）。","default":2},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja、en、both。","default":"both","examples":["both"]},"fields":{"items":{"type":"string","enum":["company","supplier_name","registration_number","corporate_number","date","invoice_date","amount","tax_amount","tax_rate","issue_date","due_date","invoice_id","subtotal","total","currency","tax_breakdown","items","customer_name","payment_method","tax_included","summary","payment_terms","supplier_address","supplier_phone","postal_code","notes"]},"type":"array","maxItems":24,"minItems":1,"title":"Fields","description":"Billing-invoice fields only; receipt_date, receipt_number, and transaction_time are rejected. / 請求書専用項目。receipt_date、receipt_number、transaction_timeは指定できません。","examples":[["supplier_name","registration_number","invoice_date","due_date","total","tax_amount","payment_terms"]]}},"additionalProperties":false,"type":"object","title":"InvoiceExtractRequest","description":"Extract and locally validate billing-invoice fields; excludes receipt-only fields and registry lookup. / 請求書項目を抽出しローカル検証します。領収書専用項目と法人データ照合は対象外です。","oneOf":[{"required":["text"]},{"required":["file_url"]},{"required":["image_base64"]}]},"InvoiceExtractVerifyRequest":{"properties":{"text":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Text","description":"Already available document text. Choose exactly one primary source: text, image_base64, or file_url. / 既に取得済みの文書テキスト。主入力としてtext、image_base64、file_urlのいずれか1つを指定します。","examples":["登録番号 T1013301046627 合計110000円 消費税10000円"]},"image_base64":{"anyOf":[{"type":"string","maxLength":35000000,"minLength":1},{"type":"null"}],"title":"Image Base64","description":"Base64-encoded image, PDF, HEIF, or TIFF file. / 画像、PDF、HEIF、TIFFファイルのBase64文字列。"},"file_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"File Url","description":"HTTPS URL for an image or document file. / 画像・文書ファイルのHTTPS URL。"},"mime_type":{"type":"string","maxLength":80,"title":"Mime Type","description":"Input MIME type; inferred when omitted. / 入力MIMEタイプ。未指定時は推定します。","default":"image/jpeg"},"max_pages":{"type":"integer","maximum":2.0,"minimum":1.0,"title":"Max Pages","description":"Maximum PDF pages to process (1-2). / 処理するPDF最大ページ数（1〜2）。","default":2},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja、en、both。","default":"both","examples":["both"]},"fields":{"items":{"type":"string","enum":["company","supplier_name","registration_number","corporate_number","date","invoice_date","amount","tax_amount","tax_rate","issue_date","due_date","invoice_id","subtotal","total","currency","tax_breakdown","items","customer_name","payment_method","tax_included","summary","payment_terms","supplier_address","supplier_phone","postal_code","notes"]},"type":"array","maxItems":24,"minItems":1,"title":"Fields","description":"Billing-invoice fields only; receipt_date, receipt_number, and transaction_time are rejected. / 請求書専用項目。receipt_date、receipt_number、transaction_timeは指定できません。"},"supplier_name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Supplier Name","description":"Optional issuer name supplied by the caller for registry comparison. / 法人データ照合用の発行者名（任意）。"},"address":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Address","description":"Optional issuer address supplied by the caller for registry comparison. / 法人データ照合用の発行者住所（任意）。"}},"additionalProperties":false,"type":"object","title":"InvoiceExtractVerifyRequest","description":"Extract and locally validate a billing invoice, then compare and resolve issuer identity using NTA invoice/corporate registries. / 請求書を抽出・ローカル検証し、国税庁のインボイス・法人番号データで発行者情報を照合・補完します。","oneOf":[{"required":["text"]},{"required":["file_url"]},{"required":["image_base64"]}]},"InvoiceExtractVerifyResponse":{"properties":{"workflow":{"type":"string","title":"Workflow","description":"Combined OCR, local-validation, and registry-resolution workflow identifier. / OCR・ローカル検証・法人照合を組み合わせたワークフロー識別子。","default":"jp-invoice.extract-and-verify.v1"},"extraction":{"$ref":"#/components/schemas/ExtractResult","description":"Invoice OCR and deterministic local-validation result. / 請求書OCRと決定論的ローカル検証結果。"},"verification":{"$ref":"#/components/schemas/InvoiceCheckResponse","description":"T-number verification, issuer comparison, and registry-backed resolution. / T番号検証、発行者比較、法人データによる補完結果。"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja、en、both。","default":"both"}},"type":"object","required":["extraction","verification"],"title":"InvoiceExtractVerifyResponse"},"InvoiceIssuerMatchExtractRequest":{"properties":{"supplier_id":{"anyOf":[{"type":"string","maxLength":128,"minLength":1,"pattern":"^[ -~]+$"},{"type":"null"}],"title":"Supplier Id","description":"Your internal supplier ID, echoed unchanged. / 仕入先ID。入力値をそのまま返します。"},"client_reference":{"anyOf":[{"type":"string","maxLength":128,"minLength":1,"pattern":"^[ -~]+$"},{"type":"null"}],"title":"Client Reference","description":"Your request reference, echoed unchanged. / リクエスト参照。入力値をそのまま返します。"},"expected":{"anyOf":[{"$ref":"#/components/schemas/ExpectedSupplier"},{"type":"null"}],"description":"Expected T-number or corporate number from supplier master data. / 仕入先マスターの照合用T番号または法人番号。","examples":[{"registration_number":"T1013301046627"}]},"text":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Text","description":"Already available document text. Choose exactly one primary source: text, image_base64, or file_url. / 既に取得済みの文書テキスト。主入力としてtext、image_base64、file_urlのいずれか1つを指定します。","examples":["請求書 宏達株式会社 登録番号 T1013301046627 請求日 2026年10月31日 合計110,000円"]},"image_base64":{"anyOf":[{"type":"string","maxLength":35000000,"minLength":1},{"type":"null"}],"title":"Image Base64","description":"Base64-encoded image, PDF, HEIF, or TIFF file. / 画像、PDF、HEIF、TIFFファイルのBase64文字列。"},"file_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"File Url","description":"HTTPS URL for an image or document file. / 画像・文書ファイルのHTTPS URL。"},"mime_type":{"type":"string","maxLength":80,"title":"Mime Type","description":"Input MIME type; inferred when omitted. / 入力MIMEタイプ。未指定時は推定します。","default":"image/jpeg"},"max_pages":{"type":"integer","maximum":2.0,"minimum":1.0,"title":"Max Pages","description":"Maximum PDF pages to process (1-2). / 処理するPDF最大ページ数（1〜2）。","default":2},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja、en、both。","default":"both"},"fields":{"items":{"type":"string","enum":["company","supplier_name","registration_number","corporate_number","date","invoice_date","amount","tax_amount","tax_rate","issue_date","due_date","invoice_id","subtotal","total","currency","tax_breakdown","items","customer_name","payment_method","tax_included","summary","payment_terms","supplier_address","supplier_phone","postal_code","notes"]},"type":"array","maxItems":24,"minItems":1,"title":"Fields","description":"Billing-invoice fields only; receipt_date, receipt_number, and transaction_time are rejected. / 請求書専用項目。receipt_date、receipt_number、transaction_timeは指定できません。"}},"additionalProperties":false,"type":"object","title":"InvoiceIssuerMatchExtractRequest","oneOf":[{"required":["text"]},{"required":["image_base64"]},{"required":["file_url"]}]},"InvoiceIssuerMatchRequest":{"properties":{"supplier_id":{"anyOf":[{"type":"string","maxLength":128,"minLength":1,"pattern":"^[ -~]+$"},{"type":"null"}],"title":"Supplier Id","description":"Your internal supplier ID, echoed unchanged. / 仕入先ID。入力値をそのまま返します。"},"client_reference":{"anyOf":[{"type":"string","maxLength":128,"minLength":1,"pattern":"^[ -~]+$"},{"type":"null"}],"title":"Client Reference","description":"Your request reference, echoed unchanged. / リクエスト参照。入力値をそのまま返します。"},"expected":{"anyOf":[{"$ref":"#/components/schemas/ExpectedSupplier"},{"type":"null"}],"description":"Expected T-number or corporate number from supplier master data. / 仕入先マスターの照合用T番号または法人番号。","examples":[{"registration_number":"T1013301046627"}]},"document":{"$ref":"#/components/schemas/InvoiceDocumentFields","description":"Issuer fields printed on the invoice. / 請求書に記載された発行者情報。","examples":[{"registration_number":"T1013301046627","issuer_name":"宏達株式会社"}]},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response language: ja, en, or both. / 応答言語：ja、en、both。","default":"both"}},"additionalProperties":false,"type":"object","required":["document"],"title":"InvoiceIssuerMatchRequest"},"InvoiceIssuerMatchResponse":{"properties":{"workflow":{"type":"string","const":"jp-invoice.issuer-match.v1","title":"Workflow"},"decision":{"type":"string","enum":["issuer_matched","supplier_mismatch","document_conflict","registration_problem","insufficient_evidence","source_unavailable"],"title":"Decision"},"decision_label_en":{"type":"string","title":"Decision Label En"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"supplier_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Id"},"client_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Reference"},"values":{"additionalProperties":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object"},"type":"object","title":"Values"},"dimensions":{"additionalProperties":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"null"}]},"type":"object"},"type":"object","title":"Dimensions"},"dates":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Dates"},"next_actions":{"items":{"type":"string"},"type":"array","title":"Next Actions"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"source_type":{"type":"string","enum":["live_api","public_snapshot","none"],"title":"Source Type"},"data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data As Of"},"data_freshness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Freshness"},"checked_at":{"type":"string","title":"Checked At"},"registry_check":{"additionalProperties":true,"type":"object","title":"Registry Check"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。"},"reason_labels_en":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reason Labels En"},"reason_labels_ja":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reason Labels Ja"}},"additionalProperties":false,"type":"object","required":["workflow","decision","decision_label_en","reasons","supplier_id","client_reference","values","dimensions","dates","next_actions","source","source_type","data_as_of","data_freshness","checked_at","registry_check","response_language"],"title":"InvoiceIssuerMatchResponse"},"InvoiceResponse":{"properties":{"registration_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Number"},"record_found":{"type":"boolean","title":"Record Found","default":false},"status":{"type":"string","title":"Status"},"status_label_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Label En"},"verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verdict"},"format_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Format Valid"},"checksum_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Checksum Valid"},"qualified_invoice_registered":{"type":"boolean","title":"Qualified Invoice Registered","default":false},"match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Match"},"verification_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Scope"},"entity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity"},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"registered_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Name"},"registered_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registered Name En"},"name_en_official":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Official"},"name_en_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Display"},"name_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Source"},"name_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Confidence"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"address_en_official":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Official"},"address_en_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Display"},"address_en_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Source"},"address_en_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address En Confidence"},"currency":{"type":"string","title":"Currency","default":"JPY"},"registration_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Date"},"update_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Update Date"},"disposal_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disposal Date"},"cancel_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cancel Date"},"expire_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expire Date"},"dataset_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Category"},"data_completeness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Completeness"},"data_freshness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Freshness"},"data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data As Of"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"verification_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verification Confidence"},"evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evidence"},"localized":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Localized"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"},"status_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Label"}},"type":"object","required":["status"],"title":"InvoiceResponse"},"InvoiceVerifyRequest":{"properties":{"registration_number":{"type":"string","maxLength":32,"minLength":1,"pattern":"^[Tt][0-9\\s\\-]{13,20}$","description":"T plus 13 digits; spaces, hyphens, and lowercase t are normalized. Shape-invalid input is rejected before payment; checksum-invalid or registry-not-found values are paid business results. / Tに続く13桁の数字。空白・ハイフン・小文字tは正規化されます。形式不正は支払い前に拒否し、チェックサム不一致または未登録は有料の業務結果として返します。","examples":["T1013301046627"]},"response_language":{"type":"string","enum":["ja","en","both"],"description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both","examples":["both"]}},"additionalProperties":false,"type":"object","required":["registration_number"],"title":"InvoiceVerifyRequest"},"JPPintValidateRequest":{"properties":{"xml":{"type":"string","maxLength":5000000,"minLength":1,"title":"Xml","examples":["<?xml version=\"1.0\" encoding=\"UTF-8\"?><Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\" xmlns:cac=\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\" xmlns:cbc=\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\"><cbc:CustomizationID>urn:peppol:pint:billing-1@jp-1</cbc:CustomizationID><cbc:ProfileID>urn:peppol:bis:billing</cbc:ProfileID><cbc:ID>INV-0001</cbc:ID><cbc:IssueDate>2026-11-01</cbc:IssueDate><cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode><cbc:DocumentCurrencyCode>JPY</cbc:DocumentCurrencyCode><cac:InvoicePeriod><cbc:StartDate>2026-10-01</cbc:StartDate><cbc:EndDate>2026-10-31</cbc:EndDate></cac:InvoicePeriod><cac:AccountingSupplierParty><cac:Party><cbc:EndpointID schemeID=\"0188\">1234567890123</cbc:EndpointID><cac:PostalAddress><cac:Country><cbc:IdentificationCode>JP</cbc:IdentificationCode></cac:Country></cac:PostalAddress><cac:PartyTaxScheme><cbc:CompanyID>T1234567890123</cbc:CompanyID><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:PartyTaxScheme><cac:PartyLegalEntity><cbc:RegistrationName>サンプル商事株式会社</cbc:RegistrationName></cac:PartyLegalEntity></cac:Party></cac:AccountingSupplierParty><cac:AccountingCustomerParty><cac:Party><cbc:EndpointID schemeID=\"0188\">3210987654321</cbc:EndpointID><cac:PostalAddress><cac:Country><cbc:IdentificationCode>JP</cbc:IdentificationCode></cac:Country></cac:PostalAddress><cac:PartyLegalEntity><cbc:RegistrationName>株式会社サンプル購買</cbc:RegistrationName></cac:PartyLegalEntity></cac:Party></cac:AccountingCustomerParty><cac:TaxTotal><cbc:TaxAmount currencyID=\"JPY\">1000</cbc:TaxAmount><cac:TaxSubtotal><cbc:TaxableAmount currencyID=\"JPY\">10000</cbc:TaxableAmount><cbc:TaxAmount currencyID=\"JPY\">1000</cbc:TaxAmount><cac:TaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>10</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:TaxCategory></cac:TaxSubtotal></cac:TaxTotal><cac:LegalMonetaryTotal><cbc:LineExtensionAmount currencyID=\"JPY\">10000</cbc:LineExtensionAmount><cbc:TaxExclusiveAmount currencyID=\"JPY\">10000</cbc:TaxExclusiveAmount><cbc:TaxInclusiveAmount currencyID=\"JPY\">11000</cbc:TaxInclusiveAmount><cbc:PayableAmount currencyID=\"JPY\">11000</cbc:PayableAmount></cac:LegalMonetaryTotal><cac:InvoiceLine><cbc:ID>1</cbc:ID><cbc:InvoicedQuantity unitCode=\"H87\">1</cbc:InvoicedQuantity><cbc:LineExtensionAmount currencyID=\"JPY\">10000</cbc:LineExtensionAmount><cac:Item><cbc:Name>Consulting service</cbc:Name><cac:ClassifiedTaxCategory><cbc:ID>S</cbc:ID><cbc:Percent>10</cbc:Percent><cac:TaxScheme><cbc:ID>VAT</cbc:ID></cac:TaxScheme></cac:ClassifiedTaxCategory></cac:Item><cac:Price><cbc:PriceAmount currencyID=\"JPY\">10000</cbc:PriceAmount></cac:Price></cac:InvoiceLine></Invoice>"]},"registry_enhance":{"type":"boolean","title":"Registry Enhance","default":false,"examples":[false]}},"additionalProperties":false,"type":"object","required":["xml"],"title":"JPPintValidateRequest"},"JPPintValidateResponse":{"properties":{"status":{"type":"string","title":"Status"},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Valid"},"document_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Document Valid"},"decision":{"type":"string","title":"Decision","default":"not_evaluated"},"trusted":{"type":"boolean","title":"Trusted","default":false},"validator":{"additionalProperties":true,"type":"object","title":"Validator"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"document_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Type"},"checks":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Checks"},"errors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Errors"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"registry":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Registry"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"},"processing_ms":{"type":"number","title":"Processing Ms"},"disclaimer":{"type":"string","title":"Disclaimer","default":"Validation evidence only; this is not legal, tax, or Peppol conformance certification."}},"additionalProperties":false,"type":"object","required":["status","evidence","processing_ms"],"title":"JPPintValidateResponse"},"JpEntityResolveRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Name","description":"English, romanized or Japanese company name. / 会社名（英語・ローマ字・日本語）。","examples":["Murata Manufacturing Co., Ltd."]},"address":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Address","description":"Address in any language; only the postal code and prefecture are used. / 住所（郵便番号と都道府県のみ使用）。"},"postal_code":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Postal Code","description":"Japanese postal code, e.g. 100-0005. / 郵便番号。"},"prefecture":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Prefecture","description":"Prefecture in English or Japanese, e.g. Tokyo, Osaka-fu, 京都府. / 都道府県。","examples":["Kyoto"]},"corporate_number":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Corporate Number","description":"13-digit corporate number (法人番号); the check digit is verified."},"t_number":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"T Number","description":"Qualified invoice registration number, T + 13 digits (登録番号); the check digit is verified."},"lei":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Lei","description":"Legal Entity Identifier (20 characters)."},"securities_code":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Securities Code","description":"Japanese securities code, e.g. 6981. / 証券コード。"},"duns":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Duns","description":"D-U-N-S number; echoed only and never verified."},"max_candidates":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Max Candidates","description":"Maximum candidates returned for a name search.","default":5}},"additionalProperties":false,"type":"object","title":"JpEntityResolveRequest","description":"Resolve a Japanese legal entity from what foreign teams hold. / 英語名や識別番号から日本の法人を特定します。"},"JpEntityResolveResponse":{"properties":{"route":{"type":"string","title":"Route"},"decision":{"type":"string","enum":["matched","likely_match","candidates","identifier_conflict","not_found","source_unavailable"],"title":"Decision"},"summary":{"type":"string","title":"Summary"},"entity":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Entity"},"match":{"additionalProperties":true,"type":"object","title":"Match"},"candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Candidates"},"next_steps":{"items":{"type":"string"},"type":"array","title":"Next Steps"},"evidence_notice":{"type":"string","title":"Evidence Notice"},"sources":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sources"},"checked_at":{"type":"string","title":"Checked At"},"conflicts":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Conflicts"}},"additionalProperties":false,"type":"object","required":["route","decision","summary","entity","match","candidates","next_steps","evidence_notice","sources","checked_at"],"title":"JpEntityResolveResponse"},"LicenseResponse":{"properties":{"category_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Code"},"authority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authority"},"license_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License Number"},"license_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"License Date"},"entity_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Name"},"corporate_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corporate Number"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"},"business_scope":{"additionalProperties":true,"type":"object","title":"Business Scope"},"source_row_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Source Row Number"}},"additionalProperties":false,"type":"object","title":"LicenseResponse"},"PostalLookupMatch":{"properties":{"postal_code":{"type":"string","title":"Postal Code"},"prefecture":{"type":"string","title":"Prefecture"},"city":{"type":"string","title":"City"},"town":{"type":"string","title":"Town"},"kana":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kana"},"confidence":{"type":"number","title":"Confidence"},"source":{"type":"string","title":"Source"}},"type":"object","required":["postal_code","prefecture","city","town","confidence","source"],"title":"PostalLookupMatch"},"PostalLookupRequest":{"properties":{"postal_code":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Postal Code","examples":["100-0001"]},"prefecture":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Prefecture"},"county":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"County"},"city":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"City"},"ward":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Ward"},"town":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Town"},"max_results":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Max Results","default":10,"examples":[10]}},"additionalProperties":false,"type":"object","title":"PostalLookupRequest","anyOf":[{"required":["postal_code"]},{"required":["prefecture"]}]},"PostalLookupResponse":{"properties":{"query":{"additionalProperties":true,"type":"object","title":"Query"},"status":{"type":"string","enum":["matched","ambiguous","not_found","unavailable"],"title":"Status"},"postal_code_match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Postal Code Match"},"candidate_count":{"type":"integer","title":"Candidate Count","default":0},"matches":{"items":{"$ref":"#/components/schemas/PostalLookupMatch"},"type":"array","title":"Matches"},"data_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Version"},"record_count":{"type":"integer","title":"Record Count","default":0},"source_status":{"type":"string","enum":["local","live","source_unavailable","disabled"],"title":"Source Status","default":"local"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"},"source_checked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Checked At"},"coverage":{"items":{"type":"string"},"type":"array","title":"Coverage"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["query","status"],"title":"PostalLookupResponse"},"ReceiptExtractRequest":{"properties":{"text":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Text","description":"Already available document text. Choose exactly one primary source: text, image_base64, or file_url. / 既に取得済みの文書テキスト。主入力としてtext、image_base64、file_urlのいずれか1つを指定します。","examples":["八福餃子房 2025年4月12日 21:18 登録番号 T1013301046627 合計12425円 内消費税1130円"]},"image_base64":{"anyOf":[{"type":"string","maxLength":35000000,"minLength":1},{"type":"null"}],"title":"Image Base64","description":"Base64-encoded image, PDF, HEIF, or TIFF file. / 画像、PDF、HEIF、TIFFファイルのBase64文字列。"},"file_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"File Url","description":"HTTPS URL for an image or document file. / 画像・文書ファイルのHTTPS URL。"},"mime_type":{"type":"string","maxLength":80,"title":"Mime Type","description":"Input MIME type; inferred when omitted. / 入力MIMEタイプ。未指定時は推定します。","default":"image/jpeg"},"max_pages":{"type":"integer","maximum":2.0,"minimum":1.0,"title":"Max Pages","description":"Maximum PDF pages to process (1-2). / 処理するPDF最大ページ数（1〜2）。","default":2},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja、en、both。","default":"both","examples":["both"]},"fields":{"items":{"type":"string","enum":["company","supplier_name","registration_number","corporate_number","date","invoice_date","receipt_date","amount","tax_amount","tax_rate","issue_date","due_date","invoice_id","subtotal","total","currency","tax_breakdown","items","customer_name","transaction_time","payment_method","tax_included","summary","supplier_address","supplier_phone","postal_code","phone_number","receipt_number","payment_terms","notes"]},"type":"array","maxItems":20,"minItems":1,"title":"Fields","description":"Receipt fields only; postal code, phone, and address checks are format/structure checks and do not verify reality or exact location. / 領収書項目のみ。郵便番号・電話番号・住所は形式・構造だけを確認し、実在性や番地の正確性は検証しません。"}},"additionalProperties":false,"type":"object","title":"ReceiptExtractRequest","description":"Extract a Japanese receipt and run local amount, tax, T-number, and contact-format checks. / 日本語の領収書を抽出し、金額・税額・T番号・連絡先形式をローカル検証します。","oneOf":[{"required":["text"]},{"required":["file_url"]},{"required":["image_base64"]}]},"ReceiptResponse":{"properties":{"document_type":{"type":"string","const":"receipt","title":"Document Type","default":"receipt"},"merchant":{"additionalProperties":true,"type":"object","title":"Merchant"},"transaction":{"additionalProperties":true,"type":"object","title":"Transaction"},"receipt":{"additionalProperties":true,"type":"object","title":"Receipt"},"amounts":{"additionalProperties":true,"type":"object","title":"Amounts"},"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items"},"qualified_invoice":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Qualified Invoice"},"extraction":{"additionalProperties":true,"type":"object","title":"Extraction"},"processing":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Processing","description":"Stable processing metadata; engine is exposed as structured_ocr. / 安定した処理メタデータ。engineはstructured_ocrとして返します。"},"validation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Validation","description":"Local format and consistency checks plus NTA T-number verification result. / ローカルの形式・整合性検証と国税庁T番号照合結果。"},"field_status":{"additionalProperties":{"type":"string"},"type":"object","title":"Field Status"},"manual_review_required":{"type":"boolean","title":"Manual Review Required","default":false},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"}},"additionalProperties":true,"type":"object","required":["merchant","transaction","receipt","amounts","extraction"],"title":"ReceiptResponse"},"RegulatedResponse":{"properties":{"decision":{"type":"string","title":"Decision"},"coverage_status":{"type":"string","title":"Coverage Status"},"source_freshness":{"type":"string","title":"Source Freshness"},"identity_match":{"type":"string","title":"Identity Match"},"license_status":{"type":"string","title":"License Status"},"matched_entity":{"anyOf":[{"$ref":"#/components/schemas/LicenseResponse"},{"type":"null"}]},"licenses":{"items":{"$ref":"#/components/schemas/LicenseResponse"},"type":"array","title":"Licenses"},"candidates":{"items":{"$ref":"#/components/schemas/CandidateResponse"},"type":"array","title":"Candidates"},"match_reasons":{"items":{"type":"string"},"type":"array","title":"Match Reasons"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"coverage":{"additionalProperties":true,"type":"object","title":"Coverage"},"response_language":{"type":"string","title":"Response Language","default":"en"},"unsupported_categories":{"items":{"type":"string"},"type":"array","title":"Unsupported Categories"}},"additionalProperties":false,"type":"object","required":["decision","coverage_status","source_freshness","identity_match","license_status"],"title":"RegulatedResponse"},"RunResponse":{"properties":{"run_id":{"type":"string","title":"Run Id"},"status_url":{"type":"string","title":"Status Url"},"request_id":{"type":"string","title":"Request Id"},"source_id":{"type":"string","title":"Source Id"},"dataset_id":{"type":"string","title":"Dataset Id"},"idempotency_key":{"type":"string","title":"Idempotency Key"},"mode":{"type":"string","title":"Mode"},"status":{"type":"string","title":"Status"},"attempt":{"type":"integer","title":"Attempt","default":1},"created_at":{"type":"string","title":"Created At"},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started At"},"finished_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finished At"},"http_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Http Status"},"etag":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Etag"},"last_modified":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Modified"},"bytes_received":{"type":"integer","title":"Bytes Received","default":0},"artifact_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Artifact Id"},"changed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Changed"},"quality_gates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Quality Gates"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"error_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Summary"}},"type":"object","required":["run_id","status_url","request_id","source_id","dataset_id","idempotency_key","mode","status","created_at"],"title":"RunResponse"},"SourceListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SourceResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"SourceListResponse"},"SourceResponse":{"properties":{"source_id":{"type":"string","title":"Source Id"},"name_ja":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name Ja"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher"},"official_page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Official Page Url"},"access_mode":{"type":"string","title":"Access Mode"},"automation_status":{"type":"string","title":"Automation Status"},"connector":{"type":"string","title":"Connector"},"credential_env":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credential Env"},"allowed_hosts":{"items":{"type":"string"},"type":"array","title":"Allowed Hosts"},"formats":{"items":{"type":"string"},"type":"array","title":"Formats"},"commercial_use":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Commercial Use"},"raw_redistribution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Redistribution"},"last_spec_checked_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Spec Checked At"},"datasets":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Datasets"}},"type":"object","required":["source_id","access_mode","automation_status","connector"],"title":"SourceResponse"},"SupplierResolveRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Name","description":"Supplier name in Japanese or English. / 仕入先名（日本語・英語）。","examples":["株式会社ABC"]},"corporate_number":{"anyOf":[{"type":"string","pattern":"^[0-9]{13}$"},{"type":"null"}],"title":"Corporate Number","description":"13-digit Japanese corporate number (法人番号), digits only. / 13桁の法人番号（数字のみ）。"},"address":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Address","description":"Supplier address, used as supporting evidence. / 仕入先住所（補助根拠）。"},"registration_number":{"anyOf":[{"type":"string","maxLength":32,"minLength":1},{"type":"null"}],"title":"Registration Number","description":"Supplier qualified-invoice registration number (T + 13 digits). / 仕入先の適格請求書登録番号（T＋13桁）。","examples":["T1013301046627"]},"t_number":{"anyOf":[{"type":"string","maxLength":32,"minLength":1},{"type":"null"}],"title":"T Number","description":"Alias of registration_number (T + 13 digits). / registration_numberの別名（T＋13桁）。"},"country_code":{"type":"string","enum":["JP","GB"],"title":"Country Code","description":"Supplier country: JP (NTA/gBizINFO) or GB (Companies House). / 仕入先の国：JP（国税庁・gBizINFO）またはGB（Companies House）。","default":"JP"},"identifiers":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object","maxProperties":8},{"type":"null"}],"title":"Identifiers","description":"Optional extra identifiers; allowed keys: corporate_number, registration_number, t_number, company_number, lei. / 追加識別子（任意）。使用可能なキー：corporate_number、registration_number、t_number、company_number、lei。"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both","examples":["both"]}},"additionalProperties":false,"type":"object","title":"SupplierResolveRequest","description":"Inputs for evidence composition; this endpoint makes no KYB conclusion.","anyOf":[{"required":["name"]},{"required":["registration_number"]},{"required":["corporate_number"]},{"required":["t_number"]},{"required":["identifiers"]}]},"SupplierResolveResponse":{"properties":{"status":{"type":"string","enum":["resolved","ambiguous","not_found","insufficient_coverage"],"title":"Status"},"identity_status":{"anyOf":[{"type":"string","enum":["verified","ambiguous","not_found","insufficient_coverage"]},{"type":"null"}],"title":"Identity Status"},"registration_status":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Registration Status"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"checks":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Checks"},"source_versions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Source Versions"},"conflicts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Conflicts"},"country_code":{"type":"string","enum":["JP","GB"],"title":"Country Code","default":"JP"},"confidence_band":{"type":"string","enum":["high","medium","low"],"title":"Confidence Band","default":"low"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"},"source_freshness":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Source Freshness"},"coverage":{"additionalProperties":true,"type":"object","title":"Coverage"},"decision":{"type":"string","enum":["verified","likely_match","ambiguous","not_found_within_coverage","insufficient_coverage"],"title":"Decision","default":"insufficient_coverage"},"confidence_reasons":{"items":{"type":"string"},"type":"array","title":"Confidence Reasons"},"checked_at":{"type":"string","title":"Checked At"},"next_actions":{"items":{"type":"string"},"type":"array","title":"Next Actions"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"}},"additionalProperties":false,"type":"object","required":["status","checked_at"],"title":"SupplierResolveResponse"},"ValidateAddressRequest":{"properties":{"address":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Address","description":"Original Japanese address; provide exactly one of address or parsed. / 元の日本住所。addressとparsedのどちらか一方を指定します。","examples":["東京都千代田区千代田1丁目1番1号"]},"parsed":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Parsed","description":"Output from /jp-address/parse or normalize containing at least one non-empty address component. / parseまたはnormalizeの出力。空でない住所構成要素を1つ以上含めます。"},"postal_evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Postal Evidence","description":"Optional prior output from /jp-address/postal-lookup; status/confidence are recomputed and not trusted. / 任意のpostal-lookup出力。statusとconfidenceは再計算され、無条件には信頼されません。"},"geocode_evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Geocode Evidence","description":"Optional prior output from /jp-address/geocode; candidates and statuses are advisory and recomputed locally. / 任意のgeocode出力。候補とstatusは補助情報で、ローカルで再計算されます。"},"required_level":{"anyOf":[{"type":"integer","maximum":8.0,"minimum":1.0},{"type":"null"}],"title":"Required Level","description":"Required hierarchy level; Jageocoder 5/6=oaza/aza, 7=block, 8=building/house node. / 必須階層。Jageocoderの5/6=大字・字、7=街区、8=建物・号ノード。","examples":[8]},"strict":{"type":"boolean","title":"Strict","description":"Require all supplied evidence to agree. / 入力された根拠の完全一致を要求。","default":false,"examples":[false]}},"additionalProperties":false,"type":"object","title":"ValidateAddressRequest","oneOf":[{"required":["address"]},{"required":["parsed"]}]},"ValidateAddressResponse":{"properties":{"match_status":{"type":"string","enum":["exact","normalized_exact","partial","ambiguous","conflict","not_found","unverified"],"title":"Match Status"},"address_validated":{"type":"boolean","title":"Address Validated"},"requested_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Requested Level"},"parsed_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parsed Level"},"verified_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Verified Level"},"precision_satisfied":{"type":"boolean","title":"Precision Satisfied","default":false},"match_level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Match Level"},"granularity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Granularity"},"postal_code_match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Postal Code Match"},"parse_confidence":{"type":"number","title":"Parse Confidence","default":0.0},"postal_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Postal Confidence"},"geographic_match_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Geographic Match Confidence"},"confidence":{"type":"number","title":"Confidence","default":0.0},"validation_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validation Source"},"validation_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validation Scope"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"},"coverage":{"items":{"type":"string"},"type":"array","title":"Coverage"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["match_status","address_validated"],"title":"ValidateAddressResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerifyRequest":{"properties":{"corporate_number":{"anyOf":[{"type":"string","pattern":"^\\d{13}$"},{"type":"null"}],"title":"Corporate Number","examples":["1234567890123"]},"name":{"anyOf":[{"type":"string","maxLength":300,"minLength":1},{"type":"null"}],"title":"Name"},"address":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Address"},"phone":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Phone"},"categories":{"items":{"type":"string"},"type":"array","maxItems":3,"minItems":1,"title":"Categories","examples":[["funds_transfer_business"]]},"response_language":{"type":"string","pattern":"^(en|ja|both)$","title":"Response Language","default":"en","examples":["en"]}},"additionalProperties":false,"type":"object","title":"VerifyRequest","anyOf":[{"required":["corporate_number"]},{"required":["name"]},{"required":["address"]},{"required":["phone"]}]},"_InvoiceIssuerMatchExtractResponse":{"properties":{"workflow":{"type":"string","const":"jp-invoice.issuer-match.v1","title":"Workflow"},"decision":{"type":"string","enum":["issuer_matched","supplier_mismatch","document_conflict","registration_problem","insufficient_evidence","source_unavailable"],"title":"Decision"},"decision_label_en":{"type":"string","title":"Decision Label En"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"supplier_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supplier Id"},"client_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Reference"},"values":{"additionalProperties":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object"},"type":"object","title":"Values"},"dimensions":{"additionalProperties":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"null"}]},"type":"object"},"type":"object","title":"Dimensions"},"dates":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Dates"},"next_actions":{"items":{"type":"string"},"type":"array","title":"Next Actions"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"source_type":{"type":"string","enum":["live_api","public_snapshot","none"],"title":"Source Type"},"data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data As Of"},"data_freshness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Freshness"},"checked_at":{"type":"string","title":"Checked At"},"registry_check":{"additionalProperties":true,"type":"object","title":"Registry Check"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。"},"reason_labels_en":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reason Labels En"},"reason_labels_ja":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reason Labels Ja"},"extraction":{"$ref":"#/components/schemas/ExtractResult"}},"additionalProperties":false,"type":"object","required":["workflow","decision","decision_label_en","reasons","supplier_id","client_reference","values","dimensions","dates","next_actions","source","source_type","data_as_of","data_freshness","checked_at","registry_check","response_language","extraction"],"title":"_InvoiceIssuerMatchExtractResponse"}},"securitySchemes":{"adminBearer":{"type":"apiKey","in":"header","name":"Authorization","description":"Operator-only control plane: `Authorization: Bearer <OFFICIAL_DATA_ADMIN_TOKEN>`. Not an x402 resource; fails closed when the token is not configured."},"batchCapabilityToken":{"type":"apiKey","in":"header","name":"Authorization","description":"Caller-chosen batch capability token (32-512 characters) sent as `Authorization: Bearer <token>`; the same token reads the job and its results."},"apiKeyBearer":{"type":"http","scheme":"bearer","bearerFormat":"jpv_live_…","description":"Account API key sent as `Authorization: Bearer jpv_live_…`."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Alternative: send the account API key as `X-API-Key: jpv_live_…`."}}},"x-discovery":{"about":"/about","terms":"/terms","privacy":"/privacy","llms":"/llms.txt","skill":"/skill.md","agent_card":"/.well-known/agent.json","security":"/.well-known/security.txt","contact_email":"service@jpverify.com","payment_flow":"Send Authorization: Bearer jpv_live_… (or X-API-Key); credits are deducted per successful request.","agent_workflows":"/.well-known/agent.json#workflows","field_policy":"/.well-known/agent.json#field_policy","x402_docs":"/docs/x402","sign_up":"https://www.jpverify.com/signup"},"tags":[{"name":"Paid APIs — highest price first / 有料API（単価の高い順）","description":"Every paid endpoint with a fixed price, most expensive first. / 固定料金の有料APIを単価の高い順に並べています。"}]}