Rate Limits

Understand how ComplyCube rate limiting works.

ComplyCube’s API enforces a maximum rate limit of 100 requests per minute. For Sandbox requests, the rate limit is 30 requests per minute.

These are hard limits that may not be increased. Any request over the limit will return a 429 Too Many Requests error.

You must implement suitable error handling for429errors. Using an exponential backoff with a random jitter is the recommended way to handle such errors.

Avoiding the limit

The tips below are some simple suggestions to help reduce the possibility of being rate limited. We recommend:

• Running non-essential or routine batch API jobs outside your peak hours.

• Throttling or avoiding batch jobs.

• Implementing exponential back-off retries, with an initial delay of 30 seconds.

• Prioritising requests that are essential to verify an active user.

• Use our webhooks instead of polling our API.