Get Tax Rates (v5.0)

API key that authenticates the request and resolves the account’s plan, entitlements, and rate limits. Supply it either as this query parameter or the X-API-KEY request header. A missing, malformed, or unknown key returns response code 101.

Serialization format of the response body. ‘json’ (default) returns a JSON object; ‘xml’ returns the same data as an XML document.

Country of the lookup: ‘USA’ (default), ‘CAN’, or a US territory (ASM, GUM, MNP, PRI, VIR). ‘CAN’ requires the Canadian rates (rate_loc_can) entitlement; otherwise the request returns response code 112. US territories are looked up via the USA path and require no additional entitlement.

5-digit US ZIP code to look up. When supplied on its own the response may contain multiple results, one per overlapping jurisdiction. An invalid format returns response code 104.

Street address to geocode to a single rooftop-level jurisdiction. Geocoding requires the geo_enabled entitlement; an incomplete or ungeocodable address returns response code 109.

State name or two-letter abbreviation. Used with city or postal code to disambiguate the location. An invalid format returns response code 102.

Two-letter state code (e.g. CA). Alternative to ‘state’ for supplying the state as a code rather than a name.

Latitude of a geographic point, from -90 to 90. Send it together with lng: when both are supplied the API resolves the single jurisdiction containing that point (coordinate lookup). A lat without lng, or a lat that is not a number from -90 to 90, returns response code 105 unless the request carries an address, which takes precedence over coordinates.

Longitude of a geographic point, from -180 to 180. Send it together with lat: when both are supplied the API resolves the single jurisdiction containing that point (coordinate lookup). A lng without lat, or a lng that is not a number from -180 to 180, returns response code 105 unless the request carries an address, which takes precedence over coordinates.

Unincorporated-area handling. Only the value ‘auto’ has an effect: on geo (address) lookups in unincorporated areas it applies the appropriate sourcing adjustment. No default is applied when omitted, and no other value (including ‘origin’/‘destination’) changes the result.

Single-article item price in dollars. Tennessee: returns the single article tax breakdown on address lookups. Arizona: when the city has a single-item rate (ADOR), returns the reduced city rate’s effect in satTaxDetail.singleItemRules on address and lat/lng lookups. Florida: county surtax capped at the first $5,000 of the item (s. 212.054(2)(b)1, F.S.), returned the same way. Requires a geo-enabled key. Tennessee’s satTaxDetail holds the local tax on the first $1,600 of the item ($300 in Hamblen County outside Morristown, $375 in Hancock County) and the 2.75% state single article tax on the part from $1,600 to $3,200.

Historical period to price the lookup against, formatted YYYYMM (6 digits, e.g. 202401). Returns the rates that were in effect for that month. Requires historical data to be enabled; an invalid format returns response code 111.