POST
/
v1
/
tax
/
id-validate
Validate a Tax ID
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 in the Sandbox environment to simulate validation of a Tax Identification Number (TIN) against government registries. This helps test compliance logic, customer verification steps, and onboarding flows without calling real tax databases.

​
Valid Tax ID Scenarios

The Sandbox supports only the specific Tax IDs below for deterministic responses. Any other values will return empty or generic results.

​
Request Parameters

Provide the following fields to simulate a validation request:

​
Response Fields

The response includes full registry metadata for the provided tax ID:

​
Notes

Only the specified test IDs listed above work in the Sandbox. All other values return limited or placeholder responses.
The customer_name field is optional, but providing it allows you to simulate name match or mismatch behavior.
This endpoint does not make live registry calls in the Sandbox environment.
Use during onboarding, KYC, or compliance testing when working with tax-registered entities.

​
Usage Tips

Use this endpoint to simulate:

  • Validation of B2B or institutional tax registrations
  • Name mismatch handling logic
  • Country-specific registry behavior across EU, India, US, etc.
  • Auditable validation logs for test environments

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.