| Element Name | Description | Example |
|---|---|---|
| emailAddress | the email address that is being validated. | jim@hotmail.com |
| mailBoxValidated | Determines if the mailbox for the email address exists. true if deliverable, false otherwise. | true/false |
| mailServerValidated | Determines if the mailserver is valid or not. It will validate do_not_send. If onboarding (particularly B2B) use this. If marketing, use deliverable. true if there is a mail server for that domain, false otherwise. | true/false |
| domainValidated | Determines if the domain is valid or not. true if the domain of the email address exists and has proper Domain Name Server (DNS) records, false otherwise. | true/false |
| blackListValidated | Determines if the user has blocked this email address. true if the email address does not appear in the internal email block list, false otherwise. You can block email addresses via Harmony Console | true/false |
| formatValidated | Determines if the syntax of the email address is valid. true if the email address syntax conforms to RFC 2822 standard,false otherwise. | true/false |
| email_valid | Attribute of the email format validation. Determines if the email format is valid or not. Valid - format is valid. (blank) - format is invalid and API timeout. | VALID, (blank) |
| domain_exists | Attribute of the domain validation. Determines if the domain exists and can receive email. Valid - domain exists. Invalid - domain does not exist or can't receive email. Unknown - unable to determine if valid or not, check email. | VALID, INVALID, UNKNOWN |
| mailserver_exists | Attribute of the mailserver validation. Determines if the mailserver is valid or not. Valid - mailserver exists. Invalid - there is no mail server present at this domain. Unknown - unable to determine if valid or not, check email. | VALID, INVALID, UNKNOWN |
| email_exists | Attribute of the mailbox validation. Valid - email is verified. Invalid - email address does not exist on mail server. Unknown - unable to verify email address. | VALID, INVALID, UNKNOWN |
| message | additional information | Email verified. Domain does not exist or cannot receive email. Email address does not exist on mail server. Please check email, unable to determine if valid or invalid. This mail server accepts all requests. Unable to verify email address. |
| do_not_send | Often these emails cause you reputation damage on email sending platforms. | true/false |
| disposable | Known Temporary email address that is used to hide the real email address of the user. These usual last 15 min to 6 months. | true/false |
| rolebased | Role based email (e.g., sales@, marketing@) and not an individual's email address. | true/false |
| catchAll | Catch all based email (e.g., donotreply@ client@) and not an individual's email address. | true/false |
| subdomain | email is subdomain email. | true/false |
| account | The portion of the email address before the "@" symbol. | jim |
| domain | The portion of the email address after the "@" symbol. | hotmail.com |
| risk | Potential impact on sender reputation score depending on all aspects. | LOW, MEDIUM, HIGH, UNKNOWN |
| suggested_email | Suggestive Fix for an email typo | jim@hotmail.com |
| deliverable | status type field | deliverable, undeliverable, do_not_send, catch_all or unknown |
| reason | List of reasons validation was unsuccessful | see reason list |
| hashsha256 | Hashed using sha256 | 4c93fb55adc02.... |
| Reason | Description |
|---|---|
| catch_all | The validity of the recipient address cannot be determined as the provider accepts any and all email regardless of whether or not the recipient’s mailbox exists. |
| disallow_list | Email is on your disallow list. |
| failed custom grammar check | The mailbox failed our local-part grammar check. |
| format_failed | Failed format syntax check. |
| high_risk_domain | Information obtained about the domain indicates it is high risk to send email to. |
| immature_domain | The domain is newly created based on the WHOIS information. |
| long_term_disposable | The mailbox has been identified as a long term disposable address. Long term disposable addresses can be quickly and easily deactivated by users, but they will not expire without user intervention. |
| mailbox_does_not_exist | The mailbox is undeliverable or does not exist. |
| mailbox_is_disposable_address | The mailbox has been identified to be a disposable address. Disposable address are temporary, generally one time use, addresses. |
| mailbox_is_role_address | The mailbox is a role based address (ex. support@…, marketing@…). |
| no_mx / No MX host found | The recipient domain does not have a valid MX host. |
| req_timeout | Timed out by request timeout setting e.g. your timeout setting. You may need to increase your timeout setting. |
| smtp_timeout | Timed out by smtp provider. |
| subdomain_mailer | The recipient domain is identified to be a subdomain and is not on our exception list. Subdomains are considered to be high risk as many spammers and malicious actors utilize them. |
| tld_risk | The domain has a top-level-domain (TLD) that has been identified as high risk. |
| unknown_provider | The MX provider is an unknown provider. |