By Address
Door-level sales tax rate for a street address
Door-level sales tax rate for a street address
Look up the single sales tax rate that applies at a specific street address. Ziptax geocodes the address down to the rooftop and returns the rate adjusted for unincorporated areas and special tax jurisdictions, which is the right answer for an actual delivery or point-of-sale location.
Use this method when you have a customer shipping address, a billing address, or a physical storefront. It’s the most accurate lookup option and what we recommend for most integrations.
Send the address in the address query parameter. The full URL-encoded
address is the only required input besides your API key.
You must also authenticate with your API key via the X-API-Key header
(recommended) or the key query parameter.
Plan-gated parameters return a specific response code if your account
doesn’t have the entitlement: countryCode=CAN returns code 112
(rate_loc_can entitlement), taxabilityCode returns code 113
(product_rates entitlement). See the
Response Codes reference for the full
list.
The full response schema (every field on baseRates, taxSummaries,
shipping, service, productDetail, etc.) is documented in the
API Reference.
Addresses contain spaces, commas, and sometimes # or &, all of
which must be percent-encoded. Most HTTP clients do this for you if
you pass the address via a params object; if you’re building URLs by
hand, use your language’s URL encoder.
You can send just street + ZIP (200 Spectrum Center Dr 92618) or
street + city + state. Ziptax normalizes to the full USPS address
regardless. Check addressDetail.normalizedAddress in the response
if you want to confirm what Ziptax actually geocoded.
Set countryCode=CAN to look up Canadian rates. Canadian lookups
require a Pro or Enterprise plan. Accounts without the rate_loc_can
entitlement will get response code 112.
Most states use destination-based sourcing, but a handful (e.g.
California’s “modified origin” rule) are more nuanced. Ziptax makes
the correct decision automatically; sourcingRules in the response
tells you which rule was applied.
TN applies a reduced state rate to the portion of a single-item sale
above a threshold. Pass the item total in sat_item_total to have
Ziptax compute the blended rate for you.