Skip to main content
GET
https://api.stateset.com
/
v1
/
tax
/
rates
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"
}
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

​
limit
integer
default:"10"
Number of tax rates to return (1-100)
​
offset
integer
default:"0"
Number of tax rates to skip
​
country
string
Filter by country code (ISO 3166-1 alpha-2)
​
state
string
Filter by state/province code
​
type
string
Filter by tax type: “sales”, “vat”, “gst”, “pst”, “hst”, “custom”
​
status
string
Filter by status: “active”, “pending”, “inactive”
​
is_inclusive
boolean
Filter by inclusive/exclusive taxes
​
effective_on
string
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"
}