| HTTP status | 429 Too Many Requests |
| Error code | rate_limit_exceeded |
| Resolve action | upgrade_plan (free tier only) |
What happened
The organization has exceeded the allowed number of API requests per minute. Rate limits are enforced per organization and vary by plan:| Plan | Limit |
|---|---|
| Free | 1,000 requests/minute |
| Paid | 10,000 requests/minute |
Response headers
Responses for API-key-authenticated requests include rate limit headers so clients can track their usage:| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests allowed per minute |
X-RateLimit-Remaining | Requests remaining in the current window |
X-RateLimit-Reset | Seconds until the rate limit window resets |
Retry-After | Seconds to wait before retrying (only on 429 responses) |
How to fix
Wait for the rate limit window to reset. TheRetry-After response header indicates how many seconds to wait before retrying. Reduce your request rate or implement exponential backoff to avoid hitting the limit repeatedly.