Verification

Verify one or many T-numbers

get/v1/verify

Request

  • Base URL: https://jp-verify.obolpay.xyz
  • URL: https://jp-verify.obolpay.xyz/v1/verify
  • Auth: one of:
    • none
    • API key in header X-API-Key

Query parameters

numberstring

a single T-number

numbersstring

comma-separated T-numbers

corporate_numberstring

reverse lookup: a 13-digit 法人番号 (Corporate Number). A qualified-invoice number is T + the 法人番号 for corporations, so this resolves deterministically to its T-number and verifies it.

signinteger
includestring

comma-separated add-ons. shareholders embeds each corporate result's full major_shareholders block (holders[] and filings[]) instead of the free compact object, and costs +1 unit per result that actually carries rows (status: available); a status-only answer costs nothing extra. Ignored where the feature is off.

Headers

X-API-Keystring

Response

One record per well-formed input number (a not_registered or invalid record carries every documented key, null where the register has nothing to say — never an absent key); malformed inputs are listed under invalid[], unmetered. The example is the real response of this code on a sample register.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.