POST
/
v1
/
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 to determine whether a product or service is taxable in a specific jurisdiction and retrieve the full tax rate breakdown, including reverse charge and exemption status.


Request Paramters

The request body accepts the following fields:


Response Fields

Returns tax determination and detailed rates:


Notes

All rate fields are integers multiplied by 1000 (e.g., 19000 = 19%)
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 is determined automatically based on customer and jurisdiction
This endpoint is optimized for real-time use during transaction or invoice creation.

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.