Live Environment Limits
| API Group | Rate Limit |
|---|---|
/v1/tax/rate, /v1/tax/id-validate, /v1/tax/unify | 1000 requests per minute |
Other endpoints (e.g., /customers, /invoices, etc.) | 300 requests per minute |
Sandbox Environment Limits
| API Group | Rate Limit |
|---|---|
/v1/tax/rate, /v1/tax/id-validate, /v1/tax/unify | 30 requests per minute |
Other endpoints (e.g., /customers, /invoices) | Not available in sandbox |
Response Headers
Each API response returns rate limit headers so you can monitor usage:| Header | Description |
|---|---|
X-RateLimit-Limit | Max allowed requests per minute |
X-RateLimit-Remaining | Remaining calls in the current window |
X-RateLimit-Reset | Time (Unix epoch) when the rate limit resets |
Response
Exceeding Limits
When you exceed the limit:- You’ll receive a
429 Too Many Requestserror - The response will include a helpful message
- Headers will guide retry timing
Best Practices
Cache tax results wherever possible
Use exponential backoff on 429 errors
Monitor rate limit headers programmatically