Rate limits
Authenticated requests are limited to 200 requests per minute per account in the current API contract. Successful responses expose these headers:
| Header | Meaning |
|---|---|
X-RateLimit-Limit |
Maximum requests in the current window. |
X-RateLimit-Remaining |
Requests remaining in the window. |
X-RateLimit-Reset |
Seconds until the window resets. |
When the limit is exceeded, the API returns 429 Too Many Requests with the standard error envelope and the too_many_requests code.
Client guidance
- Treat
429as retryable, but respect the reset value. - Add jitter to backoff when multiple workers share one account.
- Reduce polling frequency for long-running tasks; do not poll every second.
- Prefer one list request with an appropriate page size over many single-record requests.
- Log the request ID and error details when a retry ultimately fails.
Rate limits are account-level in the current documentation. Check the changelog if future versions introduce endpoint-specific limits.