4 min read
Rate Limits
Understand rate limits and best practices for staying within them.
Default Limits
1,000
Requests per minute
100
Concurrent connections
Rate Limit Headers
Every response includes headers to help you track your usage:
| Header | Description |
|---|---|
X-RateLimit-Limit | Max requests per window |
X-RateLimit-Remaining | Requests remaining in window |
X-RateLimit-Reset | Unix timestamp when window resets |
Best Practices
- Cache responses — Avoid redundant API calls by caching data that doesn't change frequently.
- Use webhooks — Instead of polling for changes, subscribe to webhook events.
- Batch operations — Where possible, use list endpoints with filters instead of individual GET requests.
- Implement backoff — When you receive a
429, wait before retrying using exponential backoff. - Monitor headers — Check
X-RateLimit-Remainingto proactively throttle requests.