Rate Limits

Understand API rate limits and how to handle them.

Rate limits protect the API from abuse and ensure fair usage for all customers.

Current limits

  • Standard - 100 requests/minute
  • Pro - 500 requests/minute
  • Enterprise - Custom limits

Rate limit headers

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1609459200

When limit is exceeded

You'll receive a 429 Too Many Requests response:

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Please retry after 60 seconds.",
  "retry_after": 60
}

Best practices

  • Implement exponential backoff
  • Cache responses when possible
  • Use webhooks instead of polling
  • Batch requests where supported