This endpoint returns a paginated list of tax rates. You can filter by jurisdiction, type, status, and more.
Authentication
This endpoint requires a valid API key with tax:read permissions.
Authorization: Bearer YOUR_API_KEY
Query Parameters
Number of tax rates to return (1-100)
Number of tax rates to skip
Filter by country code (ISO 3166-1 alpha-2)
Filter by state/province code
Filter by tax type: “sales”, “vat”, “gst”, “pst”, “hst”, “custom”
Filter by status: “active”, “pending”, “inactive”
Filter by inclusive/exclusive taxes
Filter rates effective on a specific date (ISO 8601)
Response
Returns a paginated list of tax rate objects.
curl --location 'https://api.stateset.com/v1/tax/rates?country=US&status=active' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"object": "list",
"data": [
{
"id": "tax_rate_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "tax_rate",
"name": "California State Sales Tax",
"code": "CA_STATE_SALES",
"rate": 0.0725,
"type": "sales",
"jurisdiction": {
"country": "US",
"state": "CA",
"level": "state",
"display_name": "California, United States"
},
"is_inclusive": false,
"status": "active",
"created_at": "2024-01-20T11:00:00Z"
},
{
"id": "tax_rate_1234f083-bb2d-54d6-bg6d-1b0e3gd75f41",
"object": "tax_rate",
"name": "San Francisco County Tax",
"code": "SF_COUNTY_SALES",
"rate": 0.0175,
"type": "sales",
"jurisdiction": {
"country": "US",
"state": "CA",
"county": "San Francisco",
"level": "county",
"display_name": "San Francisco County, California, United States"
},
"is_inclusive": false,
"status": "active",
"created_at": "2024-01-20T11:05:00Z"
}
],
"has_more": true,
"total_count": 127,
"url": "/v1/tax/rates"
}
