Quickstart

Create a free Ziptax account

Head to platform.zip.tax and sign up. The free tier is enough for this walkthrough and for evaluating the API.

Copy your API key

After signing in, open API Keys in the dashboard. Create a new key if one isn’t already there and copy the value. It looks like a long opaque string. Keep it out of client-side code and source control.

Make your first call

Replace YOUR_API_KEY and run this:

$
curl -H "X-API-Key: YOUR_API_KEY" \
>
  "https://api.zip-tax.com/request/v60?address=200+Spectrum+Center+Dr+Irvine+CA"

If the key and address are valid, you’ll get a JSON response that looks like this (trimmed):

1
{
2
  "metadata": {
3
    "version": "v60",
4
    "response": { "code": 100, "name": "RESPONSE_CODE_SUCCESS" }
5
  },
6
  "taxSummaries": [
7
    { "rate": 0.0775, "taxType": "SALES_TAX", "summaryName": "Total Base Sales Tax" }
8
  ],
9
  "addressDetail": {
10
    "normalizedAddress": "200 Spectrum Center Dr, Irvine, CA 92618-5003, United States",
11
    "geoLat": 33.65253,
12
    "geoLng": -117.74794
13
  }
14
}

taxSummaries[0].rate is the combined sales tax rate at that address. For 200 Spectrum Center Dr it’s 7.75% at the time of writing.

Do the same call from an SDK

The REST endpoint is easy to hit from any language, but the SDKs add typed models, retries, and convenience helpers. Pick one:

1
# pip install ziptax
2
from ziptax import Ziptax
3
4
client = Ziptax(api_key="YOUR_API_KEY")
5
rate = client.by_address(
6
    address="200 Spectrum Center Dr, Irvine CA"
7
)
8
print(rate.tax_summaries[0].rate)  # 0.0775

Pick your next step

You’re integrated. Now find the shape that matches your use case: