Resources

Result codes

Everything you can get back from the API — verification statuses, HTTP codes, and error objects.

Verification statuses

Status	Meaning	Send?
valid	Mailbox exists and accepts mail.	Yes
invalid	Syntax, MX, or SMTP failed definitively.	No
disposable	Throwaway provider (mailinator etc).	Usually no
catchall	Domain accepts everything; mailbox unverifiable.	Risk-based
unknown	Greylisting or timeout. Not billed.	Retry later

HTTP status codes

200	OK	Request succeeded.
400	Bad Request	Invalid parameters; see error.code.
401	Unauthorized	Missing or invalid API key.
402	Payment Required	Out of credits.
404	Not Found	Resource (job, verification) does not exist.
429	Too Many Requests	Rate limit hit; back off using Retry-After.
5xx	Server Error	Transient. Retry with exponential backoff.

Error object

{
  "error": {
    "code": "invalid_email",
    "message": "The provided email is not a valid address.",
    "param": "email",
    "request_id": "req_01JAE..."
  }
}