Rate Limits

Adzen enforces rate limits at the gateway layer (Azure APIM) to protect the matching pipeline from overload.

Response headers

Every response includes the current rate-limit state:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1714502400

When you hit the limit

The API returns 429 Too Many Requests with a Retry-After header (in seconds). Back off and retry after the stated interval.

HTTP/1.1 429 Too Many Requests
Retry-After: 3
Content-Type: application/json
 
{ "error": "rate limit exceeded" }

We recommend exponential backoff with jitter for retries.