REST API
Rate limits

Summary

Rate limits

To maintain the performance and reliability of our API we enforce the following rate limits on API requests:

  • Maximum of 5 concurrent requests at any given time
  • 300 requests per minute (equivalent to 5 requests per second)
  • 900 requests per 15 minutes (equivalent to 1 request per second)

When a rate limit is reached, Missive API will return the following HTTP error status code: 429 Too Many Requests with the following headers:

Retry-After How many seconds the client should wait before attempting a new request
X-RateLimit-Limit The rate limit ceiling that is applicable for the current request
X-RateLimit-Remaining The number of requests left for the current rate-limit window
X-RateLimit-Reset The time at which the rate limit resets, specified in UTC epoch time (in seconds)

Scenarios

To help you better understand how to manage your requests, here are a couple of scenarios and how you can handle them.

Continuously query the API (24/7)

Send at most 1 request per second. In most programming languages, you can achieve this with a 1-second “sleep” between requests.

Periodic bursts of requests

Send at most 5 requests per second. This way you can spread your usage over time, for instance:

  • one burst of 900 requests lasting 3 minutes, every 15 minutes
  • one burst of 600 requests lasting 2 minutes, every 10 minutes
  • one burst of 300 requests lasting 1 minute, every 5 minutes


Last updated on July 17th, 2023

Need more specific answers?

Contact us via our Help Center