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.
GET
https://{your_api_domain}/external/v1/tax-rate/queryAuthentication
Include your API key in the X-API-Key request header.
X-API-Key: <your_api_key>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}