Jurisdiction and date
Send the country, optional state or province, and the effective date you want to check.
CountryState or provinceDate
Coverage
Know when the API can calculate—and when it will not guess.
Check a specific jurisdiction, item tax category, transaction type, seller registration, customer evidence, and date before creating a sales tax calculation.
Coverage lookup
GET /v1/coverage ?country=CA &state=ON &tax_code=saas &transaction_type=sale qualified | review_required| unsupportedCoverage lookup is optional.
Sales tax calculation requests return their own sales tax calculation outcome, including review_required or unsupported, without a preceding coverage request.
Lookup inputs
What the endpoint checks.
Send the details for the transaction you want to check. A country name alone is not enough.
Item and transaction
Identify the item tax code, transaction type, and customer type for the lookup.
Tax codeSale typeCustomer type
Seller and customer facts
Include seller registrations and customer evidence when those facts affect support.
Seller countryRegistrationsCustomer evidence
Responses
Coverage outcomes.
The endpoint returns one of three answers for the supplied combination.
Supported
qualifiedThe supplied combination is supported for the requested date.
Review required
review_requiredThe supplied facts or qualified authority do not support a determinate answer. Resolve the missing information in your own workflow.
Not supported
unsupportedThe combination is not currently supported. The API does not invent a tax amount.
Use the coverage endpoint when you need it.
Check a specific combination without creating a sales tax calculation. Sales tax calculation requests work without a preceding coverage call.
Optional lookupSpecific transactionNo guessed tax