POST
/
v1
/
tax
/
unify
Unified Tax Rate + Tax ID Validation
curl --request POST \
  --url https://sandbox.antei.com/v1/tax/unify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "product_id": "prod_abc123",
  "delivery_method": "CLOUD",
  "customer_id": "cust_xyz456",
  "tax_id": "US123456789",
  "country": "US",
  "state": "CA",
  "postal_code": "94016",
  "ip_address": "192.168.1.1",
  "customer_name": "Acme Inc."
}'
{
  "taxability": true,
  "country_rate": 123,
  "state_rate": 123,
  "county_rate": 123,
  "additional_rate": 123,
  "special_rate": 123,
  "total_rate": 123,
  "reverse_charge_applicable": true,
  "exempt": true,
  "tax_id_valid": true,
  "customer_name_registry": "<string>",
  "customer_name_match": true,
  "customer_type": "<string>",
  "validated_country": "<string>",
  "validated_state": "<string>",
  "registry_address": "<string>",
  "validation_source": "<string>",
  "validation_timestamp": "2023-11-07T05:31:56Z",
  "request_id": "<string>"
}

Use this endpoint in the Sandbox environment to simulate both tax rate calculation and tax ID validation in a single call. It is useful for validating your end-to-end integration during development for workflows such as checkout, invoice generation, or regulatory compliance.

​
Valid Tax ID Scenarios

The Sandbox supports specific Tax IDs for deterministic test cases. Use only the values listed below for expected behavior.

​
Tax Rate Simulation

These combinations return predictable tax calculations in the Sandbox.

​
Request Parameters

​
Response Fields

​
Notes

All rate fields are returned in basis points. 18000 = 18%.
Only specific test combinations and IDs work in the Sandbox. Any other inputs may yield default or empty responses.
product_id takes precedence over product_category if both are present.
customer_id takes precedence over customer_type if both are present.
Reverse charge is computed automatically based on customer classification and location.
This unified endpoint is ideal for real-time compliance, especially in invoicing or payment workflows.

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

Response

200
application/json

Unified tax result and tax ID validation

The response is of type object.