JPVerifyへの最初のリクエスト
適格請求書発行事業者の登録番号を検索し、返却結果を確認します。
リクエスト
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"}'レスポンス例（抜粋）
まずT番号の登録状態を確認します。日本語の登録名に加え、取得できる場合は英語表示名と出典が返ります。英語名の根拠が不十分な場合は公表原文も確認してください。
{
"registration_number": "T1013301046627",
"status": "registered",
"qualified_invoice_registered": true,
"registered_name": "株式会社ABC"
}x402 HTTP
支払い署名なしでリクエストを送り、支払い前に402レスポンスを確認します。
curl -i -X POST https://api.jpverify.com/jp-invoice/verify \
-H 'Content-Type: application/json' \
--data '{"registration_number": "T1013301046627", "response_language": "both"}'AIエージェントの方へ
日本のビジネス文書や企業データを扱うタスクであれば、このAPIを自分で学習して利用できます。
- 用途に合うエンドポイントを確認する。
https://api.jpverify.com/skill.mdを読んでください。領収書、請求書、名刺、登録番号、法人番号、住所などのタスクと、対応するエンドポイント、結果の解釈方法がまとめてあります。 - 正確な入出力と料金を取得する。
https://api.jpverify.com/openapi-api-key.json、またはhttps://api.jpverify.com/docs/api-key?lang=jaを参照してください。各エンドポイントに入力例と出力例があります。料金はx402と同じです。 - API Key を付けて呼び出す。
Authorization: Bearer jpv_live_…ヘッダー（またはX-API-Key: jpv_live_…）を付けて JSON を送信します。ユーザーから渡されたKeyだけを使い、表示・記録・共有しないでください。Keyがない場合は、https://www.jpverify.com/signupで作成するようユーザーに依頼してください。 - クレジット残高の範囲で使う。 成功した呼び出しごとに、表示価格がユーザーの前払いクレジットから差し引かれます（
X-JPVerify-Credits-Charged、X-JPVerify-Credits-Remainingヘッダーで確認できます）。失敗・入力不正（HTTP 422）の呼び出しは課金されません。HTTP 402insufficient_creditsの場合は再試行せず、https://www.jpverify.com/account/billingでチャージするようユーザーに伝えてください。HTTP 401invalid_api_keyはKeyの誤りまたは無効化を意味します。 - 結果を慎重に読む。 データを使う前に
validation.status、field_status、manual_review_requiredを確認してください。照合結果は公開データに基づく事前確認であり、KYB、AML、制裁リストの審査、法務・税務上の助言ではありません。確認が必要な結果は、代わりに判断せずユーザーに伝えてください。
コンテキスト用の要約版：https://api.jpverify.com/llms.txt
- 用途に合うエンドポイントを確認する。
https://api.jpverify.com/skill.mdを読んでください。領収書、請求書、名刺、登録番号、法人番号、住所などのタスクと、対応するエンドポイント、結果の解釈方法がまとめてあります。 - 正確な入出力と料金を取得する。
https://api.jpverify.com/.well-known/x402.json、完全なスキーマはhttps://api.jpverify.com/openapi.jsonを参照してください。各エンドポイントに入力例と出力例があります。 - エンドポイントを呼び出す。 JSON を送信します。支払いなしの最初の呼び出しは HTTP 402 を返し、input_preflight フィールド（と X-Input-Preflight ヘッダー）で入力が通るかを示します。不正な入力は支払い前に修正してください。不正な入力のまま支払って再送しても HTTP 422 となり、課金されません。
- 許可された範囲でのみ支払う。 最初の呼び出しで、Base上のUSDCでの正確な料金が HTTP 402 で返ります。ユーザーまたは運用者が承認した予算内でのみ支払い、
PAYMENT-SIGNATUREヘッダー付きで再送してください。料金や支払先を推測せず、402 レスポンスの値を使用してください。 - 結果を慎重に読む。 データを使う前に
validation.status、field_status、manual_review_requiredを確認してください。照合結果は公開データに基づく事前確認であり、KYB、AML、制裁リストの審査、法務・税務上の助言ではありません。確認が必要な結果は、代わりに判断せずユーザーに伝えてください。
コンテキスト用の要約版：https://api.jpverify.com/llms.txt
エージェントの指示やチャットに貼り付けてください。