Skip to main content

Rate limits

important

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 api@ourpeople.com 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.

tip

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.

Headers​

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

where:

  • 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.
note

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.