Retrieving Tax Rates
Sales-tax rates by jurisdiction (rate is a decimal, e.g. 0.0825).
Use GET /api/v1/tax-rates to page through every record in your organization, or GET /api/v1/tax-rates/{id} to fetch a single record. The id is a UUID, and a 404 means it doesn't exist in your organization.
API Endpoint
Current Use Cases
Look up the rate by state or zip so invoices and storefront checkouts use the same tax as Cloudbox.
Send active tax rates to your ecommerce platform so checkout matches your invoices.
List every rate with its label to confirm you're collecting in the right places.
Pair rates with invoices to break down tax collected by jurisdiction.
Required Headers
Every request must include the following:
Requests missing either header will return 401 Unauthorized
Example Request
Response Schema
Filters
Errors
Cloudbox uses standard HTTP status codes to indicate API success or failure:
- 200–299 – Request succeeded
- 400 – Bad request (missing parameters, invalid values)
- 401 – Unauthorized (missing or invalid API keys)
- 404 – Resource not found
- 429 – Too many requests (rate limited)