Get Sales Tax Rates
GET/v1/sales_tax_ratesThe Sales Tax Rates endpoint returns a rate based on the provided input address. Currently, the endpoint supports addresses within the United States only.
Request
The name of the country associated with the address (Max 50 characters). This field is required.
The state associated with the address (Max 100 characters). This field is required.
The ZIP code of the address (Max 20 characters). This field is required.
Indicates whether country, city, or street fields are mandatory.
The name of the city associated with the address (Max 100 characters).
The county associated with the address (Max 100 characters).
The street address (Max 200 characters).
Date format - YYYY-MM-DD, default value now if not sent
Request samples
Responses
Unique identifier for the request.
The original address provided in the request.
Details of the requested address.
Effective date of the request.
Details of the real address in the US based on the request address.
Matched address details.
Scoring data for the matched address.
Tax rate details for the matched address.
State tax rate.
County tax rate.
City tax rate.
Metropolitan tax rate.
Special district tax rate.
Other applicable tax rates.
Total tax rate applicable.
{
"complytId": "414d3ef7-e282-4e29-9c77-ba7d3a349c33",
"requestAddress": {
"address": {
"country": "US",
"state": "NY",
"zip": "10001",
"isPartial": true
},
"effectiveDate": "2024-01-01T00:00:00"
},
"matchedAddressData": {
"address": {
"city": "New York",
"country": "United States",
"county": "New York",
"state": "New York",
"zip": "10001"
},
"scoring": {
"matchLevel": "EXCELLENT",
"score": 1,
"fieldScore": {
"countryMatch": "EXACT",
"stateMatch": "EXACT",
"cityMatch": "NO_MATCH",
"zipMatch": "EXACT"
}
}
},
"salesTaxRates": {
"stateRate": 0.04,
"countyRate": 0,
"cityRate": 0.045,
"spdRate": 0,
"mtayRate": 0,
"otherRate": 0,
"combinedDistrictRate": 0.00375,
"ratesMetaData": {
"cityDistrictRate": 0,
"countyDistrictRate": 0.00375,
"specialDistrictRate": 0
},
"taxRate": 0.08875
}
}