The Timeout Parameter

The timeout parameter tells the API how long it should try to verify an email before giving up and returning an unknown result code. The total request time can exceed this timeout, as network latency is not taken into consideration. This can be helpful when verifying emails at the point of entry to prevent long wait times for your users.

📘
Usage Guidelines
Please be sure to review our usage guidelines for the API here.

📘
Handling Aliases
When verifying emails that contain aliases that use a + character extra consideration needs to be taken when encoding these for x-www-form-urlencoded content-types. Make sure this character is being encoded as %2B, as the + character is treated as a non-breaking space when the string is decoded.

Result Codes

The result property contains a string that correlates to a result codes listed int the table below. For detailed information about result codes visit our help docs or click the "Learn More" links next to the result codes below.

Result Code	Description
valid	Verified as real address. Learn More
invalid	Verified as not valid. Learn More
disposable	A temporary, disposable address. Learn More
catchall	A domain wide-setting, also known as Accept-all (Unverifiable). Learn More
unknown	The server cannot be reached. Learn More

Flags

The flags will give you additional information that we discovered about the domain during verification. Below is a list of common flags you may encounter.

Flag	Description
has_dns	The input has one or more DNS records associated with the hostname.
has_dns_mx	The input has mail exchanger DNS records configured.
bad_syntax	The input given doesn't appear to be an email.
free_email_host	This email is registered on a free-mail host. (e.g: yahoo.com, hotmail.com)
profanity
role_account	This email is a role-based email address (e.g: admin@, help@, sales@)
disposable_email	The input given is a disposable email.
government_host	The input given is a government email.
academic_host	The input given is a acedemic email.
military_host	The input given is a military email.
international_host	INT designated domain names.
squatter_host	Host likely intended to look like a big-time provider (type of spam trap).
spelling_mistake	The input was misspelled
bad_dns
temporary_dns_error
connect_fails	Unable to connect to remote host.
accepts_all	Remote host accepts mail at any address.
contains_alias	The email address supplied contains an address part and an alias part.
contains_subdomain	The host in the address contained a subdomain.
smtp_connectable	We were able to connect to the remote mail server.
spamtrap_network	Host is affiliated with a known spam trap network.
historical_response	Indicates the result was generated using the historical-driven algorithm

Suggested Correction

These are soft suggestions that may correct common typos such as "gmal.com" or "hotmal.com".

200200