Rate limits
Two ceilings: a monthly call quota tied to your plan, and a short-window burst limit measured per minute. Both scale with tier.
Response headers
Every response carries your current monthly state:
| X-RateLimit-Limit | Monthly call ceiling for your tier. |
| X-RateLimit-Remaining | Calls remaining until the monthly reset. |
| X-RateLimit-Reset | Unix timestamp when the monthly counter resets to zero. |
| Retry-After | Sent only on 429 responses. Seconds to wait before retrying. |
When you exceed
Requests over either ceiling return 429 RATE_LIMITED with a Retry-Afterheader. The server keeps a small safety buffer; you won't hit 429 unexpectedly if you respect the headers.
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Remaining: 0
{
"error": {
"code": "RATE_LIMITED",
"message": "burst ceiling exceeded; retry after 12s",
"request_id": "..."
}
}Ceilings by tier
| Tier | Monthly calls | Burst | Concurrency |
|---|---|---|---|
| Pro | 5,000 | 60 / min | 5 |
| Business | 25,000 | 180 / min | 20 |
| Scale | 100,000 | 600 / min | 60 |