Every API response includes rate limit headers so your integration can monitor its usage and react before hitting a limit.
Standard Headers #
These headers are included on all API responses:
| Header | Description |
|---|---|
X-RateLimit-Limit | The total number of requests allowed in the current window |
X-RateLimit-Remaining | The number of requests remaining in the current window |
X-RateLimit-Reset | Unix timestamp (UTC) when the current window resets |
Rate Limit Exceeded Response #
When the rate limit is exceeded, the API returns HTTP 429 Too Many Requests and includes an additional header:
| Header | Description |
|---|---|
Retry-After | Number of seconds until the rate limit resets and requests are accepted again |
The response body follows the standard error envelope:
{
"error": {
"code": "rate_limit_exceeded",
"message": "You have exceeded the rate limit for this API key.",
"request_id": "req_abc123"
}
}