Postman

You can explore the entire API in Postman in about a minute by importing the OpenAPI spec — no hand-built collection required.

1. Import the API

In Postman: Import → paste the spec URL and import it.

https://api.taxql.com/openapi.json

Postman generates a collection with every endpoint — tax lookup, Portability (rates / orders / nexus), /v1/freshness, and /healthz — with each parameter pre-filled from the spec.

2. Add your API key

Every request needs the X-API-Key header.

1. Open the collection’s Variables tab and add:

   • baseUrl → https://api.taxql.com
   • apiKey → your key

2. On the collection’s Authorization (or a collection-level Header), send the key on every request:

   X-API-Key: {{apiKey}}

Caution

Put your key in the variable’s Current value, not its Initial value. Postman exports Initial values — a collection exported with a key baked in leaks it. Keep the key in Current value (never exported) and never commit an exported collection that contains it.

3. Send a request

Open GET /v1/tax/{state}, set the state path variable to tx, add an address query parameter, and Send:

GET {{baseUrl}}/v1/tax/tx?address=500 W 5th St, Austin, TX 78701
X-API-Key: {{apiKey}}

You’ll get the default flat { "rate": {…}, "meta": {…} } response (see the API overview). Add mode=full as a query parameter for the verbose per-jurisdiction body.

Keeping it current

Re-import the spec whenever you want the latest endpoints and parameters — the spec at api.taxql.com/openapi.json always reflects the live API.