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 month. Monthly rate limits are reset every 1st of each month.

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-Montly-Limit: Your monthly limit, e.g the maximum number of API calls allowed per month (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 month.
  • 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, please contact us at [email protected]. The burst rate limit unfortunately cannot be changed for now.


Did this page help you?