Skip to main content
POST
/
business
/
verification
/
tin
Verify a TIN
curl --request POST \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/verification/tin \
  --header 'Content-Type: application/json' \
  --header 'X-Numero-Api-Key: <api-key>' \
  --data '
{
  "tin": "<string>",
  "idempotencyKey": "<string>"
}
'
{ "data": { "id": 123, "status": "Completed", "verificationType": "<string>", "fee": "<string>", "feeCurrency": "<string>" }, "error": { "message": "<string>", "param": "<string>" }, "meta": { "request_id": "<string>", "pagination": { "page": 123, "page_size": 123, "total": 123, "has_more": true } } }

Authorizations

X-Numero-Api-Key
string
header
required

Your business API key (live_key_...). Issued on approval; managed in Dashboard → Settings → Developer.

Body

application/json
tin
string
required
idempotencyKey
string | null

Optional — makes retries safe.

Response

Verification result

Canonical response envelope for the public surface. data on success, error on failure.

data
object
required

Shape varies by product; common fields shown.

error
object
required
meta
object
required