POST
/
v1
/
tax
/
id-validate
curl --request POST \
  --url https://sandbox.antei.com/v1/tax/id-validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tax_id": "US123456789",
  "country": "US",
  "customer_name": "Acme Inc.",
  "ip_address": "192.168.1.1"
}'
{
  "valid": true,
  "customer_name": "<string>",
  "customer_name_match": true,
  "customer_type": "<string>",
  "country": "<string>",
  "state": "<string>",
  "address": "<string>",
  "source": "<string>",
  "validation_timestamp": "2023-11-07T05:31:56Z",
  "request_id": "<string>"
}

Use this endpoint to validate a Tax ID against official tax authority records. This ensures regulatory compliance and helps verify customer authenticity before transactions.

​
Request Parameters

The following fields can be included in the request:

​
Response Fields

A successful response will include:

​
Usage Tips

Use this endpoint during:

  • Onboarding of B2B or institutional customers
  • Validation of VAT/GST registration numbers
  • Compliance and audit workflows requiring verified registry data

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Idempotency-Key
string

Optional. Unique key to ensure idempotent operations (e.g., retry-safe requests).

Body

application/json

Details required for Tax ID validation

The body is of type object.

Response

200
application/json

Validation result returned successfully

The response is of type object.