Skip to main content
The response headers describe your current rate limit following every request in conformance with the IETF standard:
Header nameDescription
ratelimit-limitMaximum number of requests allowed within a window.
ratelimit-remainingHow many requests you have left within the current window.
ratelimit-resetHow many seconds until the limits are reset.
ratelimit-windowThe window size in seconds for the rate limit.
retry-afterHow many seconds you should wait before making a follow-up request.

​
Rate Limit Responses

The default maximum rate limit is 2 requests per second. This number can be increased upon request. After that, you’ll hit the rate limit and receive a 429 response error code. You can find all 429 responses by filtering for 429 at the OMOPHub Logs page. To prevent this, we recommend reducing the rate at which you request the API. This can be done by introducing a queue mechanism or reducing the number of concurrent requests per second. If you have specific requirements, contact support to request a rate increase.