ziptax
Look up U.S. sales tax rates using the ZipTax API.
Setup & Installation
Install command
clawhub install ericlakich/ziptaxIf the CLI is not installed:
Install command
npx clawhub@latest install ericlakich/ziptaxOr install with OpenClaw CLI:
Install command
openclaw skills install ericlakich/ziptaxor paste the repo link into your assistant's chat
Install command
https://github.com/openclaw/skills/tree/main/skills/ericlakich/ziptaxWhat This Skill Does
Looks up U.S. sales tax rates via the ZipTax API. Supports address, ZIP code, and lat/lng queries across 12,000+ jurisdictions. Returns total rates plus state, county, city, and district breakdowns, along with freight and service taxability flags.
Address-level lookups return a single exact rate rather than the multiple conflicting rates a ZIP code alone can produce.
When to Use It
- 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
View original SKILL.md file
# 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) ```bash 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 ```bash curl -s "https://api.zip-tax.com/request/v60?postalcode=92618" \ -H "X-API-KEY: $ZIPTAX_API_KEY" ``` ### Lat/Lng Lookup ```bash curl -s "https://api.zip-tax.com/request/v60?lat=33.6525&lng=-117.7479" \ -H "X-API-KEY: $ZIPTAX_API_KEY" ``` ## Workflow 1. Determine lookup type: address (best), lat/lng, or postal code 2. Use **v60** (latest) for full jurisdiction breakdowns; use v10 for simple combined rate 3. Make GET request to `https://api.zip-tax.com/request/v60` with auth header 4. Check `metadata.response.code` — 100 means success 5. Read `taxSummaries[0].rate` for total sales tax rate 6. Read `baseRates` array for state/county/city/district breakdown 7. 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.
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Calculate sales tax for a customer checkout in a specific U.S. city
- 1Calculate sales tax for a customer checkout in a specific U.S. city
- 2Verify whether shipping charges are taxable in a given jurisdiction
- 3Get a jurisdiction breakdown for a multi-district address
- 4Look up tax rates by coordinates for a field service location
- 5Check account API usage against the monthly quota
Look up U.S. sales tax rates using the ZipTax API.
Security Audits
These signals reflect official OpenClaw status values. A Suspicious status means the skill should be used with extra caution.