Rate Limits

Understand API rate limits and how to handle them.

Rate Limits by Plan

Rate Limit Headers

Every response includes rate limit information:

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

Handling Rate Limits

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

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests",
  "retry_after": 60
}

Best Practices

• Implement exponential backoff when retrying
• Use batch endpoints to reduce request count
• Cache verification results when appropriate
• Monitor the X-RateLimit-Remaining header