Rate Limiting Policy

To ensure optimal performance and fair use of the Candis API, we enforce rate limits on requests. This helps maintain system reliability and prevents overloading.

Current Rate Limit

  • Limit: 500 requests per minute per organization
  • Scope: The rate limit is applied at the organization level, not the individual client level.
    This means that all requests made on behalf of a connected organization, regardless of the client making them, count toward the same limit.

Handling Rate Limit Exceedance

If the rate limit is exceeded, the API will respond with a 429 Too Many Requests status code. The response includes a Retry-After header indicating how long to wait before retrying.


Best Practices

To ensure smooth operation within the rate limits:

  1. Implement Retry Logic: In case you hit the limit, use exponential backoff to retry requests after a short delay.
  2. Optimize API Usage: Batch requests where possible and avoid making unnecessary calls.
  3. Monitor Usage: Track the number of requests made on behalf of each organization to stay within the limit.