Rate Limits
The API enforces rate limits to ensure fair usage and protect the service. Limits are applied per application.
| Limit | Default | Scope |
|---|---|---|
| Per Minute | 60 requests | Sliding window per app |
| Per Day | 10,000 requests | Rolling 24-hour window per app |
Response Headers
Rate limit headers are included on every API response, following the IETF standard (RFC 9448).
| Header | Description |
|---|---|
RateLimit-Policy | All configured windows (e.g. 60;w=60, 10000;w=86400) |
RateLimit-Limit | Maximum requests in the current window |
RateLimit-Remaining | Remaining requests in the current window |
RateLimit-Reset | Seconds until the current window resets |
Retry-After | Seconds to wait before retrying (on 429 responses only) |
Exceeding the Limit
When you exceed the rate limit, the API returns a 429 Too Many Requests response:
{
"error": "rate_limited",
"error_description": "Rate limit exceeded",
"retry_after": 42
}Respect the Retry-After header and wait before making another request. Clients that consistently exceed rate limits may have their limits reduced.