Rate limits

Requests to the Increase API are rate limited per group. In production the default limit is 100 requests per second. In sandbox the default limit is 20 requests per second. You can briefly burst above the per-second rate as long as your average stays within it.

If you expect sustained traffic above the default, reach out to us and we can raise your limit.

Being rate limited

When you exceed your quota, the API responds with a 429 status code and an error of type rate_limited_error:

{
  "type": "rate_limited_error",
  "status": 429,
  "title": "You've tried to take this action too many times in too short a window. Please wait a while and try again.",
  "detail": null,
  "retry_after": 30
}

The response includes a retry_after field with the number of seconds to wait before retrying. The same value is returned in the standard Retry-After response header.

To stay within your limit, spread requests out over time rather than sending them in large bursts. When you do receive a 429, wait for the duration indicated by the Retry-After header before retrying, and consider adding exponential backoff to your retry logic. Our SDKs automatically retry rate limited requests after the instructed delay.