OpenClaw · Skill

Ziptax

Set ZIPTAX_API_KEY env variable with your API key from https://platform.zip.tax (DEVELOP > API Keys). Free tier gives 100 calls/month. Never share your API key publicly.

Coding Agents & IDEs

v1.0.0

VirusTotal: Benign

Install

Start with the primary install command. Alternate entrypoints are included below for ClawHub and OpenClaw CLI users.

Primary command

clawhub install ericlakich/ziptax

ClawHub installer

npx clawhub@latest install ericlakich/ziptax

OpenClaw CLI

openclaw skills install ericlakich/ziptax

Direct OpenClaw install

openclaw install ericlakich/ziptax

View source

What this skill does

Set ZIPTAX_API_KEY env variable with your API key from https://platform.zip.tax (DEVELOP > API Keys). Free tier gives 100 calls/month. Never share your API key publicly.

Why it matters

Address-level lookups return a single exact rate rather than the multiple conflicting rates a ZIP code alone can produce.

Typical use cases

Calculate sales tax for a customer checkout in a specific U.S. city
Verify whether shipping charges are taxable in a given jurisdiction
Get a jurisdiction breakdown for a multi-district address
Look up tax rates by coordinates for a field service location
Check account API usage against the monthly quota

Source instructions

ZipTax Sales Tax Lookup

Setup

Set ZIPTAX_API_KEY env variable with your API key from https://platform.zip.tax (DEVELOP > API Keys). Free tier gives 100 calls/month. Never share your API key publicly.

Quick Start

Address Lookup (most accurate)

curl -s "https://api.zip-tax.com/request/v60?address=200+Spectrum+Center+Drive+Irvine+CA+92618" \
  -H "X-API-KEY: $ZIPTAX_API_KEY"

Postal Code Lookup

curl -s "https://api.zip-tax.com/request/v60?postalcode=92618" \
  -H "X-API-KEY: $ZIPTAX_API_KEY"

Lat/Lng Lookup

curl -s "https://api.zip-tax.com/request/v60?lat=33.6525&lng=-117.7479" \
  -H "X-API-KEY: $ZIPTAX_API_KEY"

Workflow

Determine lookup type: address (best), lat/lng, or postal code
Use v60 (latest) for full jurisdiction breakdowns; use v10 for simple combined rate
Make GET request to https://api.zip-tax.com/request/v60 with auth header
Check metadata.response.code — 100 means success
Read taxSummaries[0].rate for total sales tax rate
Read baseRates array for state/county/city/district breakdown
Check service.taxable and shipping.taxable for service/freight taxability

Key Points

Address > Postal code: Address gives one exact result; postal code returns all rates in that ZIP
Auth: Header X-API-KEY or query param key
Rate format: Decimal (0.0775 = 7.75%)
Response code 100 = success; check metadata.response.code
Metrics endpoint (/account/metrics) does not count against quota

Bundled Resources

scripts/lookup.sh — CLI wrapper for quick lookups. Run with --address, --lat/--lng, --postalcode, or --metrics
references/api-reference.md — Full API reference with all endpoints, response schemas, code samples, response codes, and SDK links. Read when you need endpoint details or response field definitions.

Related OpenClaw skills

Browse all →

OpenClaw Skill