Rate Limits

The Emailhook API implements rate limiting to ensure fair usage.

Rate Limit Headers

Every API response includes rate limit information:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 3600

Default Limits

Current rate limits per API key:

• 1,000 requests per hour for most endpoints
• Higher limits available on paid plans

Rate Limit Response

When you exceed the rate limit, you'll receive a 429 Too Many Requests response:

{
  "error": {
    "type": "rate_limit_exceeded",
    "message": "Too many requests, please slow down",
    "requestId": "req_abc123"
  }
}

Best Practices

1. Monitor rate limit headers to avoid hitting limits
2. Implement retry logic with exponential backoff
3. Use webhooks instead of polling for real-time updates
4. Cache responses when possible to reduce API calls