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 (v5.0)
  • Account
    • GETGet Account Metrics (v5.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 (v5.0)

GET
/request/v50
GET
/request/v50
$curl -G https://api.ziptax.com/request/v50 \
>     -H "X-API-KEY: <apiKey>" \
>     -d key=your-api-key
1{
2  "addressDetail": {
3    "geoLat": 1.1,
4    "geoLng": 1.1,
5    "incorporated": "string",
6    "normalizedAddress": "string"
7  },
8  "rCode": 1,
9  "results": [
10    {
11      "citySalesTax": 1.1,
12      "cityTaxCode": "string",
13      "cityUseTax": 1.1,
14      "countySalesTax": 1.1,
15      "countyTaxCode": "string",
16      "countyUseTax": 1.1,
17      "district1Code": "string",
18      "district1SalesTax": 1.1,
19      "district1UseTax": 1.1,
20      "district2Code": "string",
21      "district2SalesTax": 1.1,
22      "district2UseTax": 1.1,
23      "district3Code": "string",
24      "district3SalesTax": 1.1,
25      "district3UseTax": 1.1,
26      "district4Code": "string",
27      "district4SalesTax": 1.1,
28      "district4UseTax": 1.1,
29      "district5Code": "string",
30      "district5SalesTax": 1.1,
31      "district5UseTax": 1.1,
32      "districtSalesTax": 1.1,
33      "districtUseTax": 1.1,
34      "geoCity": "string",
35      "geoCounty": "string",
36      "geoPostalCode": "string",
37      "geoState": "string",
38      "originDestination": "string",
39      "stateSalesTax": 1.1,
40      "stateUseTax": 1.1,
41      "taxSales": 1.1,
42      "taxUse": 1.1,
43      "txbFreight": "string",
44      "txbService": "string"
45    }
46  ],
47  "version": "string",
48  "satTaxDetail": {
49    "appliedTotal": "string",
50    "countyTaxRate": "string",
51    "localTaxLimit": "string",
52    "localTaxTotal": "string",
53    "stateAdditionalTaxTotal": "string"
54  }
55}

Returns comprehensive tax rates with geocoding support, multi-district breakdown, and Tennessee Single Article Tax calculations. Supports both USA and Canada.

Was this page helpful?

Get Account Metrics (v5.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
adjustmentstringOptional<=100 characters
Address adjustment parameter
sat_item_totaldoubleOptional>=0
Single Article Tax item total for Tennessee
historicalstringOptionalformat: "^[0-9]{6}$"
Historical date for rates

Response

OK
addressDetailobject
Address details
rCodelong

Response code (100=success)

resultslist of objects or null
Tax rate results
versionstring
API version
satTaxDetailobject
Tennessee Single Article Tax details

Errors

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