Skip to content
VerifyMaillAPI

Rate limits

The API enforces rate limits to keep the service fast and fair. Limits apply per API key.

Limits

Section titled “Limits”
Scope Limit
Single verify requests [N] requests / second per key
Concurrent bulk jobs [N] per account
Burst [N] requests

Need higher throughput? Contact support@verifymaill.com.

Rate-limit headers

Section titled “Rate-limit headers”

Every response includes headers describing your current window:

RateLimit-Limit: 100
RateLimit-Remaining: 87
RateLimit-Reset: 1719571200

Handling 429

Section titled “Handling 429”

When you exceed a limit, the API returns 429 Too Many Requests. Back off and retry after the window resets.

  • Respect RateLimit-Reset (or the Retry-After header if present).
  • Use exponential backoff with jitter on retries.
  • For large volumes, prefer bulk jobs over many single requests.
attempt 1 → wait 1s → attempt 2 → wait 2s → attempt 3 → wait 4s → …

See Errors for the full list of status codes.