{"openapi":"3.1.0","info":{"title":"Japan Business Identity API / 日本企業・ビジネス情報API","description":"Japan-localized OCR and registry APIs for global AI agents. Extract Japanese business cards, receipts, and billing invoices; validate tax amounts and T-numbers locally; and verify Japanese companies against public NTA snapshots. Pay per request with USDC through x402 on Base. / グローバルAIエージェント向けの日本特化OCR・法人情報APIです。名刺・領収書・請求書を抽出し、税額・T番号をローカル検証し、国税庁の公開データで日本企業を照合します。Base上のx402とUSDCによる従量課金に対応します。\n\nDiscovery: /about, /llms.txt, /skill.md, /agents.json, /.well-known/x402.json, /openapi.json. All paid endpoints return HTTP 402 with x402 payment instructions before a successful paid retry.","version":"0.5.0"},"servers":[{"url":"https://api.jpverify.com","description":"Public API base URL"}],"paths":{"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/jp-company/verify":{"post":{"summary":"Verify Japanese Company","description":"Verify a Japanese company by corporate number or Japanese name. / 法人番号または日本語の会社名で日本企業を検証します。","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"}}}}},"x-price-usdc":"$0.005","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","x-service-name":"Japan Company Verify","x-agent-use":"Japanese company verification / 日本企業・法人番号照合: resolve a company name, 13-digit corporate number (法人番号), or address against Japan's NTA corporate registry; return active/closed status and match evidence. / 会社名、13桁の法人番号、住所を国税庁の法人番号公表データと照合し、活動状態と一致根拠を返します。"}},"/jp-company/report":{"post":{"summary":"Generate Japanese Company KYB Report","description":"Return a Japanese company KYB report with registry risk flags. / 登記状態とリスクフラグを含む日本企業のKYBレポートを返します。","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"}}}}},"x-price-usdc":"$0.05","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","x-service-name":"Japan Company Report","x-agent-use":"Japanese company KYB pre-check / 日本企業KYB事前確認: 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ではありません。"}},"/jp-address/normalize":{"post":{"summary":"Normalize Japanese Address","description":"Normalize and validate a Japanese address, with optional English display. / 日本の住所を正規化・検証し、英語表示も提供します。","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"}}}}},"x-price-usdc":"$0.005","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","x-service-name":"Japan Address Normalize","x-agent-use":"Japanese address normalization / 日本住所正規化: parse postal code, prefecture, city, and canonical address text for Japan company, invoice, and contact workflows. / 日本の会社・請求書・連絡先向けに、住所から郵便番号、都道府県、市区町村、標準住所を抽出します。"}},"/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や発行者情報の比較は行いません。","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"}}}}},"x-price-usdc":"$0.01","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","x-service-name":"Japan T-Number Verify","x-agent-use":"Japanese qualified-invoice verification / 適格請求書・インボイス登録番号検証: 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桁の適格請求書登録番号を国税庁データと照合し、登録・取消・未検出の状態、法人番号、日付を返します。"}},"/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を行いません。","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"}}}}},"x-price-usdc":"$0.03","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","x-service-name":"Japan Invoice Issuer Check","x-agent-use":"Japanese billing-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値・登記値・採用値を返します。国税庁の法人番号データには電話番号がないため、電話番号は比較しません。"}},"/jp-company/verify-batch":{"post":{"summary":"Verify Japanese Companies in Batch","description":"Verify up to ten Japanese companies in one request. / 1回のリクエストで最大10社の日本企業を検証します。","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"}}}}},"x-price-usdc":"$0.05","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","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. / 1回の有料リクエストで最大10件の会社名・法人番号・住所を国税庁データと照合します。"}},"/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や発行者名・住所の比較は行いません。","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"}}}}},"x-price-usdc":"$0.05","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","x-service-name":"Japan Invoice Batch Verify","x-agent-use":"Batch Japanese qualified-invoice verification / 適格請求書登録番号一括検証: verify up to 10 T+13 digit invoice registration numbers against Japan's NTA registry for accounting and AP workflows. / 最大10件のT+13桁インボイス登録番号を国税庁データと照合し、会計・買掛金処理に利用できます。"}},"/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. 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文字列を追加します。","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"}}}}},"x-price-usdc":"$0.03","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","x-service-name":"Japan Business Card OCR","x-agent-use":"Japanese business card OCR / 名刺OCR: extract bilingual contact data from Base64 or HTTPS front/back images and one-page PDF, HEIF, or TIFF files into JSON or vCard, including name, title, department, company, email, phone, address, page count, quality, and field provenance. No company or invoice verification. / 日本語・多言語の名刺OCR。表裏画像から氏名、役職、部署、会社、メール、電話、住所をJSONまたはvCardで抽出します。企業・インボイス検証は行いません。"}},"/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. 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文字列を追加します。","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"}}}}},"x-price-usdc":"$0.10","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","x-service-name":"Japan Card OCR Enrich","x-agent-use":"Japanese business card OCR and company verification / 名刺OCR・企業照合: extract Base64 or HTTPS front/back images and one-page PDF, HEIF, or TIFF files, then match the organization to Japan NTA corporate-number (法人番号) and qualified-invoice (インボイス/T番号) registries. Registry pre-check, not full KYB. / 表裏の名刺情報を抽出し、国税庁の法人番号・適格請求書（インボイス/T番号）情報と照合します。完全なKYBではありません。"}},"/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値のみです。","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"}}}}},"x-price-usdc":"$0.05","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","x-service-name":"Japan Invoice Verify","x-agent-use":"Japanese billing-invoice OCR, local validation, and NTA issuer resolution. 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に対応します。"}},"/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番号の整合性をローカル検証して、検出した適格請求書番号を確認します。電話番号・郵便番号・住所は形式または構造のみを扱います。","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"}}}}},"x-price-usdc":"$0.03","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","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に対応。電話・郵便番号・住所は形式・構造のみです。"}},"/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番号・必須項目を決定論的なローカルルールで検証します。法人データ照合は行いません。","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"}}}}},"x-price-usdc":"$0.01","x-payment-network":"eip155:8453","x-payment-protocol":"x402","x-payment-currency":"USDC","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. 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を使用します。"}}},"components":{"schemas":{"AddressNormalizeRequest":{"properties":{"address":{"type":"string","maxLength":500,"minLength":1,"title":"Address"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","default":"both"}},"additionalProperties":false,"type":"object","required":["address"],"title":"AddressNormalizeRequest"},"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"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"parse_confidence":{"type":"number","title":"Parse Confidence"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"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"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","default":"both"},"localized":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Localized"}},"type":"object","required":["normalized","parse_confidence","source"],"title":"AddressResponse"},"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","default":"both"}},"additionalProperties":true,"type":"object","required":["card","extraction","privacy"],"title":"BusinessCardResponse"},"CardAddress":{"properties":{"raw":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw"},"raw_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw En"},"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"}]},"candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Candidates"},"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"},"back_image_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Back Image Url"},"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","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"},"include_raw_text":{"type":"boolean","title":"Include Raw Text","description":"Include OCR text only when explicitly requested. / 明示的に指定した場合のみOCRテキストを返します。","default":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"}},"additionalProperties":false,"type":"object","title":"CardExtractRequest"},"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_regions":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Field Regions"},"conflicts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Conflicts"},"raw_text":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Raw Text"},"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"},"evidence_notes":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Evidence Notes"}},"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"}},"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"},"CompanyBatchRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CompanyVerifyRequest"},"type":"array","maxItems":10,"minItems":1,"title":"Items"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","default":"both"}},"additionalProperties":false,"type":"object","required":["items"],"title":"CompanyBatchRequest"},"CompanyBatchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/CompanyResponse"},"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","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","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"},"corporate_number":{"anyOf":[{"type":"string","pattern":"^[0-9]{13}$"},{"type":"null"}],"title":"Corporate Number"},"address":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Address"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","default":"both"}},"additionalProperties":false,"type":"object","title":"CompanyVerifyRequest"},"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_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","default":"both"}},"additionalProperties":true,"type":"object","title":"ExtractResult"},"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}},"type":"object","required":["status","service","network","company_registry","company_data_source","invoice_registry","invoice_data_source"],"title":"HealthResponse"},"InvoiceBatchRequest":{"properties":{"registration_numbers":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Registration Numbers"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","default":"both"}},"additionalProperties":false,"type":"object","required":["registration_numbers"],"title":"InvoiceBatchRequest"},"InvoiceBatchResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/InvoiceResponse"},"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","default":"both"}},"type":"object","required":["results","count"],"title":"InvoiceBatchResponse"},"InvoiceCheckRequest":{"properties":{"registration_number":{"type":"string","maxLength":32,"minLength":1,"title":"Registration Number"},"supplier_name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Supplier Name"},"address":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Address"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","default":"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","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"},"InvoiceExtractRequest":{"properties":{"text":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Text","description":"Already available document text; use text, image_base64, or file_url as the source. / 既に取得済みの文書テキスト。text、image_base64、file_urlのいずれかを入力します。"},"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":"InvoiceExtractRequest","description":"Extract and locally validate billing-invoice fields; excludes receipt-only fields and registry lookup. / 請求書項目を抽出しローカル検証します。領収書専用項目と法人データ照合は対象外です。"},"InvoiceExtractVerifyRequest":{"properties":{"text":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Text","description":"Already available document text; use text, image_base64, or file_url as the source. / 既に取得済みの文書テキスト。text、image_base64、file_urlのいずれかを入力します。"},"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は指定できません。"},"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. / 請求書を抽出・ローカル検証し、国税庁のインボイス・法人番号データで発行者情報を照合・補完します。"},"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"},"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","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. / Tに続く13桁の数字。空白・ハイフン・小文字tは正規化されます。"},"response_language":{"type":"string","enum":["ja","en","both"],"description":"Response presentation language: ja, en, or both. / レスポンス表示言語: ja（日本語）、en（英語）、both（両方）。","default":"both"}},"additionalProperties":false,"type":"object","required":["registration_number"],"title":"InvoiceVerifyRequest"},"ReceiptExtractRequest":{"properties":{"text":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Text","description":"Already available document text; use text, image_base64, or file_url as the source. / 既に取得済みの文書テキスト。text、image_base64、file_urlのいずれかを入力します。"},"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","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番号・連絡先形式をローカル検証します。"},"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番号照合結果。"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"},"response_language":{"type":"string","enum":["ja","en","both"],"title":"Response Language","default":"both"}},"additionalProperties":true,"type":"object","required":["merchant","transaction","receipt","amounts","extraction"],"title":"ReceiptResponse"},"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"}}},"x-discovery":{"about":"/about","llms":"/llms.txt","skill":"/skill.md","agent_card":"/.well-known/agent.json","x402_catalog":"/.well-known/x402.json","payment_flow":"Call once, read HTTP 402, pay the declared USDC amount, retry with x402 payment header."}}