Skip to main content
POST
curl

Authorizations

X-Api-Key
string
header
required

Your API key. In the dashboard, go to Integrations and open Deliveryman API Keys to create one.

Body

email
string<email>
required

Email address to verify.

Response

Success

The result of verifying an email address.

email
string<email>
required

The email address that was verified.

status
enum<string>
required

Overall result. valid: the mailbox exists and can receive email. invalid_format: not a valid email address. email_not_exists: the mailbox or domain doesn't exist. catchall: the domain accepts every address, so the mailbox can't be confirmed. full_inbox: the mailbox exists but is full. disposable: a temporary email service. dangerous: risky to send to. webmail: a webmail provider that can't be checked directly. unverifiable: the receiving server couldn't be reached or asked us to try later.

  • valid - valid
  • invalid_format - invalid_format
  • email_not_exists - email_not_exists
  • catchall - catchall
  • full_inbox - full_inbox
  • disposable - disposable
  • dangerous - dangerous
  • webmail - webmail
  • unverifiable - unverifiable
Available options:
valid,
invalid_format,
email_not_exists,
catchall,
full_inbox,
disposable,
dangerous,
webmail,
unverifiable
deliverable
boolean | null
required

Whether the mailbox accepts email, or null if it couldn't be determined.

valid_format
boolean
required

Whether the address has a valid format.

catch_all
boolean
required

Whether the domain accepts email for any address.

full_inbox
boolean
required

Whether the mailbox is full.

disposable
boolean
required

Whether the domain is a disposable email service.

webmail
boolean
required

Whether the domain is a webmail provider.