API errors

Not found

404 · not_found

Why you got this

No record with that id exists on this account, or the path is not one the API serves.

What to do

Check the id and the path. Ids are the prefixed strings the API returns: con_, lst_, cfd_, cmp_. Numeric database keys are not accepted.

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/not_found",
  "title": "Not found",
  "status": 404
}

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