# JPVerify: Japan Business Identity API

JPVerify is a Japan-localized API for global AI agents. It extracts Japanese business cards, receipts, and billing invoices, then validates tax arithmetic, T-numbers, company numbers, and addresses according to each endpoint's documented scope.

## Start here
- Product page: https://api.jpverify.com/about
- OpenAPI 3.1: https://api.jpverify.com/openapi.json
- x402 catalog with prices and schemas: https://api.jpverify.com/.well-known/x402.json
- Agent Card: https://api.jpverify.com/.well-known/agent.json
- Agent instructions: https://api.jpverify.com/skill.md
- Health: https://api.jpverify.com/health

## Payment
All paid endpoints use x402 exact payments in USDC on `eip155:8453`. Call the endpoint once, read HTTP 402, pay the exact declared amount, and retry with the payment header. Do not send API keys.

## How to choose
- Use `/jp-receipt/extract` for Japanese receipts and expense evidence.
- Use `/jp-invoice/extract` for Japanese billing-invoice OCR plus deterministic local validation, without registry lookup.
- Use `/jp-invoice/extract-and-verify` when the invoice must also be checked against NTA invoice/corporate data.
- Use `/jp-business-card/extract` for contact fields only.
- Use `/jp-business-card/extract-and-enrich` for contact fields plus company registry enrichment.
- Use `/jp-company/verify` for a Japanese corporate-number or company-name lookup.
- Use `/jp-invoice/verify` for a T+13-digit qualified-invoice number lookup.

## Resources and prices
- `POST /jp-business-card/extract` — Japan Business Card OCR — $0.03 — Japanese business card OCR
- `POST /jp-business-card/extract-and-enrich` — Japan Card OCR Enrich — $0.10 — Japanese business card OCR and company verification
- `POST /jp-receipt/extract` — Japan Receipt OCR — $0.03 — 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.
- `POST /jp-invoice/extract` — Japan Invoice OCR — $0.01 — 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.
- `POST /jp-invoice/extract-and-verify` — Japan Invoice Verify — $0.05 — 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.
- `POST /jp-company/verify` — Japan Company Verify — $0.005 — Japanese company verification
- `POST /jp-company/report` — Japan Company Report — $0.05 — Japanese company KYB pre-check
- `POST /jp-address/normalize` — Japan Address Normalize — $0.005 — Japanese address normalization
- `POST /jp-invoice/verify` — Japan T-Number Verify — $0.01 — Japanese qualified-invoice verification
- `POST /jp-invoice/check` — Japan Invoice Issuer Check — $0.03 — Japanese billing-invoice issuer check
- `POST /jp-company/verify-batch` — Japan Company Batch Verify — $0.05 — Batch Japanese company verification
- `POST /jp-invoice/verify-batch` — Japan Invoice Batch Verify — $0.05 — Batch Japanese qualified-invoice verification

## Output and limitations
Responses support `response_language=ja`, `en`, or `both`. OCR images are not retained. Registry matching is a public-data pre-check, not full KYB, AML, sanctions screening, or personal identity verification.

## Japanese
日本語の名刺・領収書・請求書を抽出し、税額・金額・T番号を構造化検証します。法人番号・インボイス番号の照合は国税庁公開データに基づく事前確認です。