Rate Limits
Rate limits ensure fair usage and system stability. Limits are per API key and vary by plan.
Plans & Limits
Rate Limit Headers
Every API response includes rate limit headers. Monitor them to stay within limits.
X-RateLimit-Limit: 10 X-RateLimit-Remaining: 15 X-RateLimit-Reset: 1782637658
X-RateLimit-LimitMaximum requests allowed per minute for your plan
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix timestamp when the window resets
Handling 429 Responses
When rate limited, you receive HTTP 429 Too Many Requests. The Retry-After header tells you how many seconds to wait.
HTTP/1.1 429 Too Many Requests
Retry-After: 30
{
"error": {
"message": "Rate limit exceeded. Retry after 30 seconds.",
"type": "rate_limit_error",
"code": 429
}
}Best Practices
Exponential Backoff
Increase wait time between retries: 1s → 2s → 4s → 8s with jitter.
Monitor Headers
Check X-RateLimit-Remaining before sending bursts of requests.
Batch Requests
Combine multiple messages in one request when possible.
Upgrade Your Plan
Need higher limits? View our plans for increased quotas.
Plans are managed from the admin dashboard and reflect live database values.