Tax

Country, state, or ZIP. Same tax fields.

Need a tax rate? Look up the place you have. Country, state, and US ZIP responses all include tax and tax_rate. No separate endpoint, and no extra query param.

When to call which

GET

api.parseapi.com/country/{code}

National levy. Prices and invoices. US is empty

GET

api.parseapi.com/state/{code}

Subdivision base. State or province

GET

api.parseapi.com/postal/{code}?country=US

Combined local. US ZIP, checkout

curl "https://api.parseapi.com/country/de" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "country": "DE",
  "name": "Germany",
  "tax": "VAT",
  "tax_rate": 19,
  "tax_id_format": "DE999999999"
}

curl "https://api.parseapi.com/country/us" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "country": "US",
  "name": "United States",
  "tax": null,
  "tax_rate": null
}

curl "https://api.parseapi.com/state/colorado" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "state": "CO",
  "name": "Colorado",
  "tax": "Sales tax",
  "tax_rate": 2.9
}

curl "https://api.parseapi.com/postal/53202?country=US" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "postal": "53202",
  "city": "Milwaukee",
  "state": "WI",
  "state_name": "Wisconsin",
  "tax": "Sales tax",
  "tax_rate": 7.9,
  "tax_rate_state": 5,
  "tax_rate_county": 0.9,
  "tax_rate_city": 2,
  "tax_rate_special": null
}

curl "https://api.parseapi.com/postal/97201?country=US" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "postal": "97201",
  "city": "Portland",
  "state": "OR",
  "state_name": "Oregon",
  "tax": null,
  "tax_rate": 0,
  "tax_rate_state": 0,
  "tax_rate_county": null,
  "tax_rate_city": null,
  "tax_rate_special": null
}

Response fields

tax: Levy name (VAT, GST, Sales tax). Null when that layer levies none
tax_rate: Rate as a percent. Country is the national levy. State is the subdivision base. ZIP is the highest combined rate in that code
tax_rate_state: ZIP only. State piece of the combined rate, percent. Null when that level does not apply
tax_rate_county: ZIP only. County piece of the combined rate, percent. Null when that level does not apply
tax_rate_city: ZIP only. City piece of the combined rate, percent. Null when that level does not apply
tax_rate_special: ZIP only. Special district piece of the combined rate, percent. Null when that level does not apply

A ZIP with no state tax ships 0, not empty. California and Texas stay null until those files land. This is a rate lookup, not a filing engine. VAT number checks are /vat.

Questions? Email