Guides
Rate limits and errors
Handle limits, retries, and consistent error responses.
Current API limits are visible in Settings and can be raised. If a request exceeds the current limit, the API returns 429.
Limited requests
HTTP/1.1 429 Too Many Requests
retry-after: 12
x-request-id: req_...
Wait the number of seconds in retry-after before retrying.
Error body
{
"error": "rate_limited",
"message": "Rate limit exceeded.",
"meta": {
"request_id": "req_..."
}
}
Common statuses
| Status | Meaning |
|---|---|
400 | Invalid request shape, unsupported filter, or invalid date range. |
401 | Missing or invalid authentication. |
403 | Authenticated but not allowed to make this request. |
404 | Resource not found. |
429 | Rate limit exceeded. |
5xx | Server-side failure. Retry with backoff and keep the request ID. |