POST
/
v1
/
tax
/
rate
Calculate Tax Rate
curl --request POST \
  --url https://sandbox.antei.com/v1/tax/rate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "product_category": "SAAS",
  "delivery_method": "CLOUD",
  "customer_type": "B2B",
  "location": {
    "country": "US",
    "state": "CA",
    "postal_code": "94016",
    "ip_address": "192.168.1.1"
  }
}'
{
  "taxable": 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
}

Use this endpoint in the Sandbox environment to simulate tax rate scenarios for different countries, product types, and customer classifications. This helps validate integration logic and test edge cases before moving to production.

​
Tax Rate Simulation

The Sandbox environment supports specific input values to simulate deterministic behavior. You can use these values in your requests to test various scenarios.

​
Request Paramters

The request body accepts the following fields:

​
Response Fields

Returns tax determination and detailed rates:

​
Notes

All rate fields are returned in basis points. 18000 = 18%.
Only specific test combinations are supported in the sandbox. Using other values will return a default fallback.
If both product_id and product_category are provided, product_id takes priority.
If both customer_id and customer_type are provided, customer_id takes priority.
Reverse charge logic is auto-detected using customer and jurisdiction info.
Use this API to validate integration logic before pushing to production.

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

Successful tax rate breakdown

The response is of type object.