POST
/
tax
/
calculations
curl --request POST \
--url https://api.numeralhq.com/tax/calculations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"customer": {
"address": {
"address_line_1": "4 Privet Drive",
"address_city": "Little Whinging",
"address_province": "CA",
"address_postal_code": "90210",
"address_country": "US",
"address_type": "shipping"
}
},
"order_details": {
"customer_currency_code": "USD",
"tax_included_in_amount": false,
"line_items": [
{
"reference_product_id": "wand_elder_12",
"amount": 10000,
"quantity": 1
}
]
}
}'
{
"id": "calc_1726683504829b84b2ad6-a4c9-4e0e-986f-7bb3d1fb17c9",
"object": "tax.calculation",
"customer_currency_code": "USD",
"line_items": [
{
"product": {
"reference_product_name": "Elder Wand",
"reference_product_id": "wand_elder_12",
"product_tax_code": "GENERAL_MERCHANDISE"
},
"tax_jurisdictions": [
{
"tax_rate": 0.1,
"rate_type": "SALES TAX",
"jurisdiction_name": "California",
"fee_amount": 0
}
],
"quantity": 1,
"tax_amount": 1000,
"amount_excluding_tax": 10000,
"amount_including_tax": 11000
}
],
"tax_included_in_amount": false,
"total_tax_amount": 1000,
"total_amount_excluding_tax": 10000,
"total_amount_including_tax": 11000,
"expires_at": 1726683511,
"testmode": true,
"address_resolution_status": "EXACT",
"address_used": {
"address_line_1": "4 Privet Drive",
"address_city": "Little Whinging",
"address_province": "CA",
"address_postal_code": "90210",
"address_country": "US"
}
}
Get tax information for a given product and address

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-API-Version
enum<string>
default:2024-09-01

API version to use. Defaults to 2024-09-01 if not specified.

Available options:
2024-09-01,
2025-05-12

Body

application/json

Response

200
application/json

Calculate response

The response is of type object.