For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportLog InSign Up
GuidesAPI Reference
GuidesAPI Reference
  • Tax Rates
    • GETGet Tax Rates (v6.0)
  • Account
    • GETGet Account Metrics (v6.0)
  • Data
    • GETGet TIC Codes
    • POSTSearch TIC Codes
    • POSTRecommend TIC Codes
    • GETGet TIC Search JSON Schema
  • System
    • GETHealth Check
    • GETGet System Metadata
Logo
SupportLog InSign Up
Tax Rates

Get Tax Rates (v6.0)

GET
/request/v60
GET
/request/v60
$curl -G https://api.ziptax.com/request/v60 \
>     -H "X-API-KEY: <apiKey>" \
>     -d key=your-api-key
1{
2  "addressDetail": {
3    "geoLat": 1.1,
4    "geoLng": 1.1,
5    "incorporated": "true",
6    "normalizedAddress": "string"
7  },
8  "base_rates": [
9    {
10      "jur_description": "string",
11      "jur_name": "US_STATE",
12      "jur_tax_code": "string",
13      "jur_type": "US_STATE_SALES_TAX",
14      "rate": 1.1,
15      "rate_id": "string"
16    }
17  ],
18  "metadata": {
19    "rCode": 100,
20    "version": "v60"
21  },
22  "origin_destination": {
23    "adjustment_type": "ORIGIN_DESTINATION",
24    "description": "string",
25    "value": "O"
26  },
27  "service": {
28    "adjustment_type": "SERVICE_TAXABLE",
29    "description": "string",
30    "taxable": "Y"
31  },
32  "shipping": {
33    "adjustment_type": "FREIGHT_TAXABLE",
34    "description": "string",
35    "taxable": "Y"
36  },
37  "tax_summaries": [
38    {
39      "rate": 1.1,
40      "summary_name": "string",
41      "tax_type": "SALES_TAX"
42    }
43  ]
44}

Returns tax rates in a new structured format with separate base rates, service/shipping taxability, and tax summaries. Built on v5.0 data but with enhanced organization

Was this page helpful?

Get Account Metrics (v6.0)

Next
Built with

Authentication

X-API-KEYstring
API key in header

Query parameters

keystringOptional10-100 characters
API key for authentication
formatenumOptionalDefaults to json
Response format
Allowed values:
countryCodeenumOptionalDefaults to USA

Country code (USA/CAN)

Allowed values:
postalcodestringOptionalformat: "^[0-9]{5}$"=5 characters

5-digit postal code

addressstringOptional<=100 characters
Street address for geocoding
statestringOptional<=50 characters
State name or abbreviation
stateCodestringOptionalformat: "^[A-Z]{2}$"=2 characters
State code
citystringOptional<=50 characters
City name
countystringOptional<=50 characters
County name
latdoubleOptional-90-90
Latitude coordinate
lngdoubleOptional-180-180
Longitude coordinate
sat_item_totaldoubleOptional>=0
Single Article Tax item total for Tennessee
historicalstringOptionalformat: "^[0-9]{6}$"
Historical date for rates
addressDetailExtendedbooleanOptionalDefaults to false

When true, returns a full geocoding object in the response broken into address parts (street, city, postal code, etc.). Defaults to false.

shippingExtendedbooleanOptionalDefaults to false

When true, returns a detailed shipping object to help navigate collection complexity. The GENERAL_RULE value will be one of: EXEMPT, EXEMPT_WHEN_SEPARATELY_STATED, ITEM_SPECIFIC, CONDITIONAL, or TAXABLE. For EXEMPT_WHEN_SEPARATELY_STATED, the response includes a boolean flag, and a natural-language description is included for clarity. Defaults to false.

Response

OK
addressDetailobject
Address details
base_rateslist of objects or null
Base tax rates by jurisdiction
metadataobject
Response metadata
origin_destinationobject

Origin/destination taxation info

serviceobject
Service taxability information
shippingobject
Shipping taxability information
tax_summarieslist of objects or null
Tax rate summaries

Errors

400
Bad Request Error
401
Unauthorized Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error