API response
|
Field |
Possible values |
Description |
|
meta - email |
User defined |
This is the customer supplied email address. |
|
emailAddressAnalysis - mailboxVerification - result |
See table “API main status codes” |
Provides primary information on the status of an email address |
|
emailAddressAnalysis - mailboxVerification - secondaryResult |
See table “API additional status codes” |
Provides supplemental information on verifications |
|
emailAddressAnalysis - syntaxVerification - isSyntaxValid |
Boolean - True, false |
Identifies whether the email address passes RFC syntax checks |
|
emailAddressAnalysis - disposition - isGibberish |
Boolean - True, false |
Identifies whether the local part of the email address appears to be gibberish |
|
emailAddressAnalysis - disposition - isProfanity |
Boolean - True, false |
Identifies whether the local part of the email address appears to be profanity |
|
emailAddressAnalysis - disposition - isRole |
Boolean - True, false |
Identifies whether the local part of the email address appears to be a role rather than an individual. |
|
emailAddressAnalysis - disposition - isSubaddressing |
Boolean - True, false |
Identifies whether the local part of the email address contains subaddressing of some form |
|
emailAddressAnalysis - disposition - isFreeMail |
Boolean - True, false |
Identifies if the email address is associated with a freemail service e.g. Gmail, Hotmail |
|
emailAddressAnalysis - disposition - isDisposable |
Boolean - True, false |
Identifies whether the email address is associated with a Disposable Email Provider |
|
emailAddressAnalysis - disposition - hasCatchAllServer |
Boolean - True, false |
Identifies whether the email address’s server is acting as a catch all server. |
|
emailAddressAnalysis - disposition - hasBeenBlocked |
Boolean - True, false |
Identifies if the email address has been identified on a reputable block list. |
|
emailAddressAnalysis - assessments - consumerBusiness |
Integer - 0-10 |
Scores the likelihood that the email address relates to a consumer(0) or business (10). |
|
domainAnalysis - disposition - isSubDomain |
Boolean - True, false |
Identifies if the domain part of the email address is a subdomain. |
|
domainAnalysis - disposition - isGibberish |
Boolean - True, false |
Identifies if the domain part of the email address contains gibberish. |
|
domainAnalysis - disposition - isProfanity |
Boolean - True, false |
Identifies if the domain part of the email address contains profanity. |
|
domainAnalysis - disposition - isDarkWeb |
Boolean - True, false |
Identifies if the domain has been associated with the dark web. |
|
domainAnalysis - disposition - hasBeenBlocked |
Boolean - True, false |
Identifies if the domain has been identified on a reputable block list. |
|
domainAnalysis - disposition - has DNSRecords |
Boolean - True, false |
Identifies if the domain has DNS records. |
|
domainAnalysis - disposition - hasMxRecords |
Boolean - True, false |
Identifies if the domain has MX records. |
|
domainAnalysis - disposition - mailServerLocation |
See http://www.iso.org/iso/country_codes.htm |
The ISO country code for the geographic location of the primary mail server associated with the email address. |
|
domainAnalysis - disposition - mailServerInfrastructure |
String |
Describes the mail server infrastructure |
API main status codes
|
Result |
Description |
|
Ok |
Verification passes all checks including Syntax, DNS, MX, Mailbox, Deep Server Configuration, Grey listing |
|
Bad |
Verification fails checks for definitive reasons (e.g. mail box does not exist) |
|
Disposable email address |
The email address is provided by a well known disposable provider |
|
Unverifiable |
Conclusive verification result cannot be achieved due to mail server configuration or anti-spam measures. See table “Additional Status Codes”. |
API additional status codes
|
Result |
Secondary result |
Description |
|
Ok |
Success |
Successful verification |
|
Bad |
DomainDoesNotExist |
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. |
|
Bad |
EmailAddressFoundOnBlockLists |
The email address is found on one or more block lists. |
|
Bad |
EmailContainsInternationalCharacters |
Email address contains international characters. |
|
Bad |
InvalidEmailFormat |
Invalid email address format. |
|
Bad |
MailboxDoesNotExist |
The mailbox does not exist. 100% confidence that the mail box does not exist. |
|
Bad |
MailboxFull |
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. |
|
Bad |
MailServerFaultDetected |
An unspecified mail server fault was detected. |
|
Bad |
NoMailServersForDomain |
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. |
|
Bad |
PossibleSpamTrapDetected |
A possible spam trap email address or domain has been detected. |
|
Disposable email address |
DisposableEmailAddress |
The domain is a well known Disposable Email Address DEA. |
|
Unverifiable |
MailServerAntiSpam |
The email server is using anti-spam measures. Anti-spam systems and processes can include: proxy based, hosted anti-spam such as ProofPoint or MimeCast; self hosted anti-spam using remote data services such as Barracuda, SORBS or SPAMCOP; and Whitelist based systems only allow emails from pre-approved sender email address. |
|
Unverifiable |
MailServerGreyListing |
Greylisting is in operation. It is not possible to validate email boxes in real-time where greylisting is in operation. |
|
Unverifiable |
MailServerCatchAll |
The server is configured for catch all and responds to all email verifications with a status of Ok. |
|
Unverifiable |
None |
No additional information is available. |
|
Unverifiable |
Timeout |
The remote email server timed out. Mail server is too busy / overloaded, misconfigured, offline or otherwise unavailable. |
|
Unverifiable |
UnpredictableSystem |
Unpredictable system infrastructure detected. Various email services deliver unpredictable results to email address verification. The reason for this unpredictability is that some email systems elect not to implement email standards (i.e. RFC 2821). |