429 Too Many Requests with response headers that explain when you can try again.
Rate limit headers
| Header | How to use it |
|---|---|
X-RateLimit-Limit | The limit that applied to the request. Treat this as informational and avoid assuming it is the same for every account or endpoint. |
X-RateLimit-Reset-After | The rate limit window length, in seconds. |
X-RateLimit-Reset | The Unix timestamp when the current window resets. |
Retry-After | The number of seconds to wait before retrying the request. |
Example 429 response
429, wait at least the Retry-After value before sending another request. For high-volume workflows, use exponential backoff, avoid automatic immediate retries, and consolidate requests where an endpoint supports batching.
Understanding where you are in the limit
The API does not currently return a remaining-request counter. UseRetry-After and X-RateLimit-Reset on 429 responses to determine when requests can resume, and use X-RateLimit-Limit to understand the limit that was applied when throttling occurred.