Rate Limits
Rate Limits
Understand request limits and how to stay within your plan.
Limits by plan
Each plan has a monthly request quota and a per-second rate limit. Test keys do not count toward your quota.
| Plan | Monthly requests | Requests per second |
|---|---|---|
| Free | 1,000 | 2 |
| Starter | 10,000 | 5 |
| Growth | 100,000 | 20 |
| Enterprise | Custom | Custom |
Rate limit headers
Responses include headers so you can throttle client-side:
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9842
X-RateLimit-Reset: 1739123456When you exceed limits
If you exceed the per-second limit, the API returns 429 Too Many Requests. When you exceed your monthly quota, requests return 402 Payment Required until the next billing cycle or plan upgrade.
429 response body:
{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Too many requests. Retry after 2 seconds.",
"retry_after": 2
}
}Best practices
- Use exponential backoff when you receive 429 responses.
- Respect the
Retry-Afterheader when present. - For bulk workloads, use batch requests or scheduled tasks.
- Monitor usage in the dashboard.