Skip to main content

Rate limits

info

The OurPeople API is currently in a closed beta only.

API 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 support@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 contains 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 response code of 429 is returned. This response will also include a Retry-After header to indicate the remaining seconds before the rate limit is reset.

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