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. When both lat and lng are supplied the API resolves the single jurisdiction containing that point (coordinate lookup).

Longitude of a geographic point. When both lat and lng are supplied the API resolves the single jurisdiction containing that point (coordinate lookup).

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 total in dollars used to compute Tennessee Single Article Tax (SAT). When greater than 0 and the location is in Tennessee, the response includes the satTaxDetail object describing the local tax limit and additional state tax on the single article.

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.