Skip to main content
POST
/
v1
/
tax
/
id-validate
Validate a Tax ID
curl --request POST \
  --url https://api.antei.com/v1/tax/id-validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tax_id": "<string>",
  "country": "<string>",
  "customer_name": "<string>",
  "state": "<string>",
  "county": "<string>",
  "postal_code": "<string>",
  "ip_address": "<string>"
}
'
{
  "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:
  • tax_id (string, required) – The customer’s Tax Identification Number.
  • customer_name (string, optional) – The legal name of the customer. Used for name match checks.
  • country (string, required) – ISO 3166-1 alpha-2 country code (e.g., US, DE, IN).
  • state (string, optional) – State or region. Useful for country-specific lookups.
  • county (string, optional) – County or district name (if applicable).
  • postal_code (string, optional) – ZIP or postal code for geolocation support.
  • ip_address (string, optional) – User’s IP address to infer location when address fields are missing.

​
Response Fields

A successful response will include:
  • valid (boolean) – Whether the Tax ID is valid.
  • customer_name (string) – The official name associated with the Tax ID.
  • customer_name_match (boolean) – Whether the provided name matches the registry.
  • customer_type (string) – Entity classification. One of:
    • B2C – Business to Consumer
    • B2B – Business to Business
    • PRISCH – Private School
    • PRIEDUI – Private Educational Institution (Non-School)
    • GOV – Government Entity
    • PUBSCH – Public School
    • PUBEDU – Public Educational Institution (Non-School)
    • PRIHOS – Private Hospital
    • PUBHOS – Public Hospital
    • NGO – Non-Governmental Organization
  • country (string) – Country associated with the registry.
  • state (string) – State or region returned from the registry (if available).
  • address (string) – Registered address (if available).
  • source (string) – Authority or data source used for validation (e.g., VIES, GSTIN).
  • validation_timestamp (string) – ISO timestamp of the validation event.
  • request_id (string) – Unique reference for tracing and support.

​
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

​
tax_id
string
required

The tax identification number to validate

​
country
string
required

The country where the tax ID should be validated (ISO 3166-1 alpha-2)

​
customer_name
string

Optional customer name for matching against registry

​
state
string

State or region code, if applicable

​
county
string

County or district, optional

​
postal_code
string

Postal or ZIP code, optional

​
ip_address
string

IP address of the customer (used for fallback geolocation)

Response

Validation result returned successfully

​
valid
boolean

Indicates whether the Tax ID is valid

​
customer_name
string

Customer name from the tax registry (if available)

​
customer_name_match
boolean

True if the provided name matches the registry name

​
customer_type
string

Type of the customer entity (e.g., BUSINESS, INDIVIDUAL, NONPROFIT, GOV)

​
country
string

Country associated with the tax ID

​
state
string

State/province/region from registry (if available)

​
address
string

Full address from registry (if available)

​
source
string

Registry source used (e.g., VIES, GSTIN, etc.)

​
validation_timestamp
string<date-time>

Timestamp of the validation attempt

​
request_id
string

Internal reference ID for this validation request