Rate Limiting
API throttles, request limits, and backoff strategies
4 min read
API Reference
Rate Limiting
API rate limiting prevents abuse and ensures fair usage across all accounts.
Default Limits
General API Endpoints
60 requests per minute per API token
Webhook Processing
1000 webhooks per hour
DNS Operations
10 DNS writes per minute (SPF updates, DNS provider writes)
Public Endpoints
100 requests per minute per IP
Rate Limit Headers
Every API response includes rate limit information:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1691350320
Handling Rate Limits
When you hit a rate limit, the API returns 429 Too Many Requests:
{
"error": "Rate limit exceeded",
"retry_after": 30
}
Implementation tips:
- Check
X-RateLimit-Remainingbefore making requests - Implement exponential backoff on 429 responses
- Batch operations where possible
- Contact support for higher limits if needed