Skip to main content

Rate limits


The OurPeople REST API is currently in a closed beta only.

Rate limits

Using public authentication, clients are allowed 5,000 requests per hour. Rate limits are calculated in an hour block, starting from the first request you make.

If your application needs more than the allotted number of calls, please contact us at with a description of the application and an estimate on needed call usage. You might also want to investigate the use of caching to keep the number of calls to a minimum, and make your application more responsive.


If you're updating user or tag information, consider comparing hashes of the data locally to decide whether to send an update to the OurPeople API.


Every API response bears rate limit headers, which can be used to determine the number of calls remaining in the current hour.

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
X-RateLimit-Reset: 1656320012


  • X-RateLimit-Limit: The number of allowed requests in the current hour.
  • X-RateLimit-Remaining: The number of remaining requests in the current hour.
  • X-RateLimit-Reset: The unix timestamp when the current hour resets.

When a rate limit has been reached, a return response code of 429 is returned.

These default rate limits are subject to change at any time, without notice.