Rate Limits

Limits

Endpoint Type	Limit	Window
Standard (list, detail)	60 requests	1 minute
Bulk export (/export)	10 requests	1 minute

Response Headers

Header	Description
X-RateLimit-Limit	Maximum requests in current window
X-RateLimit-Remaining	Requests remaining
X-RateLimit-Reset	Unix timestamp when window resets

When Exceeded

HTTP 429 Too Many Requests
Retry-After: 60

Best Practices

1. Cache responses — Don’t fetch the same data repeatedly
2. Use webhooks — Instead of polling, register webhooks for real-time updates
3. Use cursor pagination — Fetch only new/changed data since your last sync
4. Respect Retry-After — Wait the indicated time before retrying
5. Use bulk export — For initial sync, use /export endpoints