Rate limits

Learn everything about Livestorm's API rate limits

Monthly rate limit

For security reasons, the API allows you to make 10,000 calls per 30-day period.
What does this "30-day period" mean? It means we limit to 10,000 requests per 30 days from the first request made. This limit is called later "monthly rate limit" and is reset once the 30 days are over.

Burst rate limit

Additionally, the API is protected by a burst rate limit. This means you can't make more than 5 requests per second.

Rate limit response headers

Each time you make a new request to the API, we will provide the following headers in the response:

  • RateLimit-Monthly-Limit: Your monthly rate limit, e.g the maximum number of API calls allowed per 30-day period (10k by default).
  • RateLimit-Interval-Limit: The burst rate limit, e.g the maximum number of API calls allowed per second (5 by default).
  • RateLimit-Monthly-Remaining: The total remaining API calls allowed for the current 30-day period.
  • RateLimit-Interval-Remaining: The total remaining API calls allowed for the current window of time (per second).
  • Retry-After: The number of seconds before the next time-frame where you'll be able to retry your API call.
  • RateLimit-Reset: The timestamp of the next monthly period from which your API rate calls will be reset.

What happens if I exceed my quota?

Your request will be rejected and you'll receive an HTTP 429 response code. From this point, you'll have to wait for the required time to make new successful API calls. If this happens, use the Retry-After and RateLimit-Reset to retry your API call.

πŸ“˜

Need higher limits?

If you need to upgrade your monthly API rate limit, you can increase this limit by buying an Add-on. Please contact your account manager or our support team at [email protected] for more information (kindly note that this upgrade is only possible for Business and Enterprise plans).

The burst rate limit cannot be changed for now.