SALES TAX RATE API

U.S. Sales Tax Rate API
by Street Address

Affordable tax rate lookups for ERP and ecommerce tools. Get the combined rate, jurisdiction breakdown, and match level for each shipping address.

Byte Orca / APIAddress rate lookup example
POST/external/v2/tax-rate/query
Bellevue, WA98005 · King County
State6.5%County2.4%City0%Special1.4%
Combined rate10.3%
Example order tax$11.33

Illustrative data. Example order tax is calculated from the rate and a $110 taxable amount.

HTTPSX-API-KeyJSONMulti-language examples

YOUR PRODUCT. YOUR WORKFLOW.

Your experience. Connected to tax rates.

ERP & order systems

Bring tax rates into your order workflow

Look up rates by order destination and bring state, county, city, and special district breakdowns into your system.

Order entry / Quotes / Finance tools

Ecommerce software

Use destination rates at checkout

Look up rates by shipping address and use the result in your cart and checkout workflows.

Carts / Checkout estimates / Seller tools

Developers & SaaS

Build with familiar HTTPS and JSON

Authenticate with an API key and use your existing stack. Explore request parameters and examples in multiple languages.

Backend services / Internal tools / Integrations

START WITH A REQUEST

One request returns the rate breakdown

Send a state and a list of query items. Use the same endpoint for one address or multiple addresses in the same state.

When a ZIP spans multiple tax jurisdictions

Send the house number and street in items[].address. Include city, county, and ZIP+4 when available. Check each item’s status and matchedLevel. ADDRESS indicates an address-level match.

If an item returns NO_MATCH or matches at a broader level such as ZIP when you need address precision, verify the address and retry. Route unresolved cases for review.

Explore parameters, responses, and code examples
cURL Example request
curl 'https://{your_api_domain}/external/v2/tax-rate/query' \
  -H 'X-API-Key: <your_api_key>' \
  -H 'Content-Type: application/json' \
  --data '{
    "state": "WA",
    "items": [{
      "itemId": "order-001",
      "address": "123 Main St",
      "city": "Bellevue",
      "county": "King",
      "zipCode": "98005"
    }]
  }'

Replace placeholders with your provisioned API domain and key. Keep your key on the server.

JSON response excerpt
1{2  "code": 200,3  "msg": "OK",4  "data": {5    "state": "WA",6    "totalCount": 1,7    "successCount": 1,8    "noMatchCount": 0,9    "invalidCount": 0,10    "failedCount": 0,11    "items": [{12      "itemId": "order-001",13      "status": "SUCCESS",14      "matchedLevel": "ADDRESS",15      "mainItem": {16        "taxRate": "10.3",17        "stateTaxRate": "6.5",18        "countyTaxRate": "2.4",19        "cityTaxRate": "0",20        "specialDistrictTaxRate": "1.4"21      }22    }]23  }24}

This excerpt shows the key response fields. Rates are returned as percentage strings, so "10.3" means 10.3%.

API PRICING

Choose a plan for your query volume

Monthly allowances count successful queries. Prices are in USD.

FREE DEVELOPER TESTING

100queries / month

Validate rates and match precision with your own addresses. Production plans start at $29/month.

Request API trialNo payment details needed to apply
PlanSuccessful queries / monthMonthly price
Developer testing100Free
Starter1,500$29
Growth5,000$59
Scale10,000$89
Scale Plus25,000$129
Enterprise100,000$300
Enterprise CustomOver 100,000Custom quote
Query allowances and billing
  • Each query item that returns a valid primary tax rate counts once. Successful repeat queries count separately, and batches count by successful item. Items without a valid primary rate are excluded.
  • Allowances reset monthly and unused queries expire. Developer testing is for integration validation only. When the allowance runs out, pause or upgrade.
  • If you expect to exceed your allowance, contact us to agree on an upgrade. Monthly billing and annual prepayment are available. Annual plans retain monthly allowances, with pricing confirmed by quote.

FAQ

Before you build.

Do I need an order amount to look up a rate?

No. The API uses location information to look up rates. Use the returned rate and taxable amount to calculate tax in your system.

Do you support street-address lookup?

The API accepts a street address with a house number and reports the match level. Precision depends on the local data, and a query may match at a broader level such as ZIP. Use representative addresses during your trial to check coverage and match levels.

What does the API return?

The API returns the status, actual match level, and applicable rates for each item, including available state, county, city, and special district breakdowns.

Is trial access automatic?

Our team follows up to confirm access and trial terms. Submitting the form does not automatically activate an API account or charge you.

Does the API include tax filing?

This service provides rate lookup. Contact our team for Nexus analysis, registration, or filing services.

LET’S BUILD

From trial to production

Test your integration with 100 free queries per month. Choose a production plan when you’re ready.

Try online

Request API trial

Apply with your name and email. No payment details are required. Our team will follow up by email to set up your trial.

Fields marked with an asterisk are required.

What happens after you apply

  1. Get your test domain and API key

    Our team will follow up at the email address you provide. Once trial access is ready, we’ll share the API domain for testing and arrange secure delivery of your API key.

  2. Validate your integration

    Use your 100 free test queries per month to check address match levels and applicable rates on representative orders.

  3. Confirm production access

    Confirm the states and match precision you need, your production plan’s monthly quota and rate limits, and your billing start and go-live dates. Verify the production API domain and credentials before switching live traffic.

    View API pricing