Rate Limits & Errors
Understand request quotas, response headers, and how to handle common API errors.
Rate limits
Production keys are limited to 600 requests per minute per organization. Sandbox keys are limited to 120 requests per minute.
X-RateLimit-Limit— maximum requests allowed in the windowX-RateLimit-Remaining— requests left in the current windowX-RateLimit-Reset— Unix timestamp when the window resets
When you exceed the limit, the API returns 429 Too Many Requests. Wait until the reset time or implement exponential backoff before retrying.
Error format
Errors are returned as JSON with a consistent shape:
{
"error": {
"code": "invalid_request",
"message": "The request body is invalid.",
"details": []
}
}Common error codes
| Code | HTTP | Description |
|---|---|---|
| invalid_request | 400 | The request body or parameters are malformed. |
| unauthorized | 401 | Missing or invalid API key. |
| forbidden | 403 | The key is valid but lacks permission for this resource. |
| not_found | 404 | The requested resource does not exist. |
| rate_limit_exceeded | 429 | Too many requests in the current window. |
| internal_error | 500 | Unexpected server error. Retry with backoff. |
Try the API
Use the interactive playground on the API reference page to send requests and inspect real responses.
Open API Reference