Make your first JPVerify request
Look up a qualified-invoice registration number and inspect the result.
Request
curl -i -X POST https://api.jpverify.com/jp-invoice/verify \
-H "Authorization: Bearer $JPVERIFY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"registration_number": "T1013301046627", "response_language": "both"}'Example response · excerpt
Check the T-number’s registration status first. The response can include the Japanese legal name and an English display name with its source. Review uncertain English names against the original registry record.
{
"registration_number": "T1013301046627",
"status": "registered",
"qualified_invoice_registered": true,
"registered_name": "株式会社ABC"
}x402 HTTP
Send the request without a payment signature to inspect the 402 challenge before paying.
curl -i -X POST https://api.jpverify.com/jp-invoice/verify \
-H 'Content-Type: application/json' \
--data '{"registration_number": "T1013301046627", "response_language": "both"}'Connect JPVerify MCP
Connect a compatible client using the Streamable HTTP endpoint.
For AI agents
If you are an AI agent and your task involves Japanese business documents or Japanese business data, you can learn and use this API on your own:
- Learn when to use which endpoint. Read
https://api.jpverify.com/skill.md. It maps tasks (receipts, invoices, business cards, T-numbers, corporate numbers, addresses) to endpoints and explains how to interpret results. - Get exact inputs, outputs and prices. Read
https://api.jpverify.com/openapi-api-key.json, or browsehttps://api.jpverify.com/docs/api-key. Every endpoint lists an input example and an output example; prices are the same as x402. - Call the endpoint with the key. Send JSON with the header
Authorization: Bearer jpv_live_…(orX-API-Key: jpv_live_…). Use only the key your user gave you; never print, log or share it. If you have no key, ask your user to create one athttps://www.jpverify.com/signup. - Stay within the credit balance. Each successful call deducts its listed price from your user's prepaid credits (see the
X-JPVerify-Credits-ChargedandX-JPVerify-Credits-Remainingheaders); failed or invalid calls (HTTP 422) are not charged. On HTTP 402insufficient_credits, stop and ask your user to top up athttps://www.jpverify.com/account/billing; do not retry. HTTP 401invalid_api_keymeans the key is wrong or revoked. - Read the result carefully. Check
validation.status,field_statusandmanual_review_requiredbefore acting on the data. Registry results are a public-data pre-check, not KYB, AML, sanctions screening, or legal or tax advice. If a result needs review, tell your user instead of deciding on their behalf.
Short version for your context window: https://api.jpverify.com/llms.txt
- Learn when to use which endpoint. Read
https://api.jpverify.com/skill.md. It maps tasks (receipts, invoices, business cards, T-numbers, corporate numbers, addresses) to endpoints and explains how to interpret results. - Get exact inputs, outputs and prices. Read
https://api.jpverify.com/.well-known/x402.json, orhttps://api.jpverify.com/openapi.jsonfor the full schema. Every endpoint lists an input example and an output example. - Call the endpoint. Send JSON. The first, unpaid call returns HTTP 402; its input_preflight field (and the X-Input-Preflight header) says whether the input would pass. Fix invalid input before paying: a paid retry with invalid input returns HTTP 422 and is not charged.
- Pay only if you are authorized to. The first call returns HTTP 402 with the exact USDC price on Base. Pay and retry with the
PAYMENT-SIGNATUREheader only within the budget your user or operator has approved. Never guess the price or the payment address; use the values in the 402 response. - Read the result carefully. Check
validation.status,field_statusandmanual_review_requiredbefore acting on the data. Registry results are a public-data pre-check, not KYB, AML, sanctions screening, or legal or tax advice. If a result needs review, tell your user instead of deciding on their behalf.
Short version for your context window: https://api.jpverify.com/llms.txt
Paste them into your agent's instructions or chat.