Getting Started

Rate Limits

API rate limiting and throttling

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

Limits by Tier

Tier	Per Minute	Per Day
Basic	100	5,000
Standard	500	25,000
Enterprise	2,000	100,000

Response Headers

Every response includes rate limit headers:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 487
X-RateLimit-Reset: 1709571660

Header	Description
X-RateLimit-Limit	Requests allowed per minute
X-RateLimit-Remaining	Requests remaining in window
X-RateLimit-Reset	Unix timestamp when window resets

Rate Limit Exceeded

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

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded: 500 requests per minute"
  }
}

The Retry-After header tells you how many seconds to wait:

Retry-After: 32

Best Practices

1. Implement exponential backoff — Wait longer between retries
2. Cache responses — Avoid unnecessary repeated requests
3. Use webhooks — Subscribe to events instead of polling
4. Batch operations — Use bulk endpoints when available
5. Monitor headers — Track remaining requests to avoid hitting limits