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: [email protected], [email protected], [email protected])

disposable_email

The input given is a disposable email.

government_host

The input given is a government email.

acedemic_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.

Suggested Correction

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

Language
Authentication
Query
Response
Click Try It! to start a request and see the response here!