API Rate Limits

View as Markdown

To ensure platform stability, fair usage, and optimal performance across all tenants, the ApexVerify API enforces rate limits on your requests. Our infrastructure implements a token bucket algorithm for precise allocation.

Maximum Throughput

All API consumers are bounded by a standard limit of 180 requests per minute.

Rate Limit Headers

Every successful or failed API response includes HTTP headers to help your application programmatically track its current rate limit status and consumption.

HTTP HeaderDescription
X-RateLimit-LimitThe total number of requests permitted within the allocated time window.
X-RateLimit-RemainingThe number of requests remaining in the current window before limits are enforced.
X-RateLimit-UsedThe number of requests already consumed in the current window.

Handling Rate Exceeded Errors

If your integration attempts to make requests exceeding the limit, the API will refuse the connection and respond with a 429 Too Many Requests HTTP status code.

To facilitate exponential backoff strategies, the response will also include a Retry-After header. This header specifies the number of seconds your application must pause before resuming requests.

1HTTP/1.1 429 Too Many Requests
2Retry-After: 44
3X-RateLimit-Limit: 180
4X-RateLimit-Used: 180
5X-RateLimit-Remaining: 0
6Content-Type: application/json
7
8{
9 "message": "Too Many Requests"
10}