Tax Rates

Get Tax Rates (v6.0)

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.

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: "date"
Historical date for rates

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