Docs / Shared / Rate limits & quotas

Rate limits & quotas

Every response carries your current budget, so a client can back off before it is refused rather than after.

Headers

X-RateLimit-Limit: 100        // bucket capacity, i.e. your burst
X-RateLimit-Remaining: 97     // requests left in it right now
X-RateLimit-Reset: 1          // seconds until a slot frees up
// on a 429 only
Retry-After: 1

Limiting is a token bucket, not a fixed window. Your plan's bucket holds a burst of requests and refills continuously at the sustained rate, so X-RateLimit-Remaining counts down out of X-RateLimit-Limit and climbs back on its own — there is no window boundary to line up with, which is why Reset is a countdown to the next free slot rather than a timestamp.

By plan