You can find an extensive list and explanations for our response codes using our official documentation: api-docs.emailhippo.com


Main Status Response Codes


Ok
Verification passes all checks including Syntax, DNS, MX, Mailbox, Deep Server Configuration, Grey Listing
Bad
Verification fails checks for definitive reasons (e.g. mailbox does not exist)
Retry Later
Conclusive verification result cannot be achieved at this time. Please try again later. This is ShutDowns, TimeOuts, etc
Unverifiable
Conclusive verification result cannot be achieved due to mail server configuration or anti-spam measures.


Additional Status Codes


Code

Description

None
No additional information is available.
AtSignNotFound - BAD
The required '@' sign is not found in email address.
DomainIsInexistent - BAD
The domain (i.e. the bit after the '@' character) defined in the email address does not exist, according to DNS records. A domain that does not exist cannot have email boxes.
DomainIsWellKnownDea - DEA
The domain is a well known Disposable Email Address (DEA).

There are many services available that permit users to use a one-time only email address. Typically, these email addresses are used by individuals wishing to gain access to content or services requiring registration of email addresses but same individuals not wishing to divulge their true identities (e.g. permanent email addresses).

DEA addresses should not be regarded as valid for email send purposes as it is unlikely that messages sent to DEA addresses will ever be read.
GreyListing - MailboxUnverifiable
Greylisting is in operation. It is not possible to validate email boxes in real-time where greylisting is in operation.

For more information, see https://en.wikipedia.org/wiki/Greylisting.
MailboxFull - BAD
The mailbox is full.

Mailboxes that are full are unable to receive any further email messages until such time as the user empties the mail box or the system administrator grants extra storage quota.

Most full mailboxes usually indicate accounts that have been abandoned by users and will therefore never be looked at again.

We do not recommend sending emails to email addresses identified as 'full' .We do not recommend sending emails to email addresses identified as 'full'.
MailboxDoesNotExist - BAD
The mailbox does not exist.

100% confidence that the mail box does not exist.
NoMxServersFound - BAD
There are no mail servers defined for this domain, according to DNS.

Email addresses cannot be valid if there are no email servers defined in DNS for the domain.
ServerDoesNotSupportInternationalMailboxes - BAD
The server does not support international mailboxes.

International email boxes are those that use international character sets such as Chinese/Kanji etc.

International email boxes require systems in place for Punycode translation.

Where these systems are not in place, email verification or delivery is not possible.

For further information see https://en.wikipedia.org/wiki/Punycode
ServerIsCatchAll - MailboxUnverifiable
The server is configured for catch all and responds to all email verifications with a status of Ok.

Mail servers can be configured with a policy known as Catch All. Catch all redirects any email address sent to a particular domain to a central email box for manual inspection. Catch all configured servers cannot respond to requests for email address verification.
Success - OK
Successful verification.

100% confidence that the mail box exists.
TooManyAtSignsFound - BAD
Too many '@' signs found in email address.

Only one '@' character is allowed in email addresses.
TransientNetworkFault - RetryLater
A temporary network fault occurred during verification. Please try again later.

Verification operations on remote mail servers can sometimes fail for a number of reasons such as loss of network connection, remote servers timing out etc.

These conditions are usually temporary. Retrying verification at a later time will usually result in a positive response from mail servers.

Please note that setting an infinite retry policy around this status code is inadvisable as there is no way of knowing when the issue will be resolved within the target domain or the grey listing resolved, and this may affect your daily quota.
PossibleSpamTrapDetected - BAD
A possible spam trap email address or domain has been detected.

Spam traps are email addresses or domains deliberately placed online in order to capture and flag potential spam based operations.

Our advanced detection heuristics are capable of detecting likely spam trap addresses or domains known to be associated with spam trap techniques.

We do not recommend sending emails to addresses identified as associated with known spam trap behavior.

Sending emails to known spam traps or domains will result in your Email Service Provider (ESP) being subjected to email blocks from Reverse DNS Block Lists (RDNSBL)s.

ESPs cannot tolerate entries in RDNSBLs (as it adversely affects email deliverability for all customers) and will actively refuse to send emails on behalf of customers with a history of generating entries in RDSNBLs.