Rate Limits

Understand how ComplyCube rate limiting works.

ComplyCube’s API enforces a maximum rate limit of 10 requests per second. For Sandbox requests, the rate limit is 5 requests per second.

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 for 429 errors. Using an exponential backoff with a random jitter is the recommended way to handle such errors.

Avoiding the limit

To help prevent reaching rate limits, consider the following best practices:

• Run non-essential or routine batch jobs outside of peak hours.

• Throttle or limit the frequency of batch jobs.

• Implement exponential backoff for retries, starting with a 30-second delay.

• Prioritize requests that are essential to verifying active clients.

• Use webhooks instead of polling our API for updates.