API errors

Rate limit exceeded

429 · rate_limited

Why you got this

More than 300 requests in five minutes on this API key. The limit is per key.

What to do

Wait the number of seconds in the Retry-After header, then retry. That header carries the whole window, so it can be longer than the time actually left. If you are syncing in bulk, batch your writes rather than looping one contact at a time.

How it arrives

Every failure on the API is an RFC 7807 problem document, sent asapplication/problem+json. Branch on type — or on its last segment, which is the code above — rather than ontitle or detail, which are prose and may be reworded.

{
  "type": "https://emailfig.com/docs/errors/rate_limited",
  "title": "Rate limit exceeded",
  "status": 429
}

Every code

• account_closing — Account is closing
• confirmation_unavailable — Confirmation email cannot be sent
• contact_cleaned — Address is marked cleaned
• invalid_api_key — Invalid or missing API key
• malformed_request — Malformed request
• not_found — Not found
• rate_limited — Rate limit exceeded
• server_error — Something went wrong on our end
• suppressed_cannot_resubscribe — Address cannot be resubscribed
• validation_failed — Validation failed

Back to the API reference