Developer Portal

Build with Byte Orca

Public API contracts for sales tax calculation and transaction ingestion, with implementation-ready examples.

GET API

Sales Tax API

Connect external systems to Byte Orca's sales tax rate query and calculation service.

Endpoint

Send tax rate requests over HTTPS. State and ZIP Code are required; city and county improve local matching accuracy.

GEThttps://{your_api_domain}/external/v1/tax-rate/query

Authentication

Include your API key in the X-API-Key request header.

X-API-Key: <your_api_key>

Request parameters

Request parameters
Parameter	Required	Type	Description
stateCode	Required	string	US 2-letter state code, for example CA or WA.
zipCode	Required	string	5-digit ZIP code.
city	Optional	string	City name. Improves matching accuracy when provided.
county	Optional	string	County name. Improves matching accuracy when provided.
amount	Optional	decimal	Product amount. Omit to return rates only.
shippingAmount	Optional	decimal	Shipping amount. Defaults to 0.00.
productType	Optional	integer	Product type code. 1 is Tangible Personal Property by default.

Request example

Code

1curl -i -G 'https://{your_api_domain}/external/v1/tax-rate/query' \2  -H 'X-API-Key: <your_api_key>' \3  -d 'stateCode=WA' \4  -d 'zipCode=98005' \5  -d 'amount=100.00' \6  -d 'shippingAmount=10.00'

Success response

HTTP 200 OK · Response format

Code

1{2  "code": 200,3  "msg": "OK",4  "data": {5    "match": {6      "stateCode": "WA", "zipCode": "98005",7      "city": "Bellevue", "county": "King",8      "matchType": "STATE_ZIP", "confidence": "EXACT"9    },10    "rates": {11      "unit": "DECIMAL", "combinedRate": "0.103",12      "stateRate": "0.065", "countyRate": "0.024",13      "cityRate": "0", "specialRate": "0.014"14    },15    "calculation": {16      "amount": "100.00", "shippingAmount": "10.00",17      "taxableAmount": "110.00", "estimatedTax": "11.33",18      "totalAmount": "121.33"19    }20  }21}