Skip to main content
bthebigclass
All help topics

For developers

Rate limits + the X-RateLimit-* headers

60 requests/minute and 1,000/day per API key. Every response carries headers so your client can back off proactively.

Limits

  • 60 requests per minute, aligned to clock minutes (resets at :00).
  • 1,000 requests per day, aligned to UTC midnight.
  • Token-bucket: the failed-rate-limited request doesn't consume budget.

Headers (always present)

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 47
X-RateLimit-Reset: 1715990400
X-RateLimit-Daily-Limit: 1000
X-RateLimit-Daily-Remaining: 832
X-RateLimit-Daily-Reset: 1716076800
Retry-After: 12      # only on 429 responses

Pre-emptively back off when X-RateLimit-Remaining is under 5 — otherwise you'll trip a 429 and have to wait for the Retry-After window.

Enterprise plans get custom quotas — talk to us if 60/min isn't enough for your integration.