Email Validation (emailValidation) Details
Applies to: Direct | Capture
This JSON response is returned for an email address verification check.
This response is returned by
/get-resultsif you call the/submit-email-addressendpoint
{
"emailValidation": {
"type": "object",
"description": "Response data returned by an email validation check.",
"required": [
],
"properties": {
"data": {
"required": [
],
"properties": {
"disposable": {
"type": "boolean",
"description": "Is this email suspected of belonging to a temporary or disposable mail service? Usually associated with fraudsters and scammers."
},
"domain_age": {
"required": [
],
"properties": {
"timestamp": {
"type": "integer",
"description": "The unix time since epoch when this domain was first registered. (Ex: 1568061634)"
},
"human": {
"type": ["string", "null"],
"description": "A human description of when this domain was registered. (Ex: 3 months ago)"
},
"iso": {
"type": "string",
"description": "The time this domain was registered in ISO8601 format (Ex: 2019-09-09T16:40:34-04:00)"
}
},
"type": "object"
},
"suggested_domain": {
"type": "string",
"description": "Default value is \"N/A\". Indicates if this email's domain should in fact be corrected to a popular mail service. This field is useful for catching user typos. For example, an email address with \"gmai.com\", would display a suggested domain of \"gmail.com\". This feature supports all major mail service providers."
},
"smtp_score": {
"type": "integer",
"description": "Validity score of email server's SMTP setup. Range: -1 to 3. Scores above -1 can be associated with a valid email. -1 = invalid email address. 0 = mail server exists, but is rejecting all mail. 1 = mail server exists, but is showing a temporary error. 2 = mail server exists, but accepts all email. 3 = mail server exists and has verified the email address."
},
"associated_names": {
"required": [
],
"description": "Displays first and last names linked to the email address, if available. Match rates vary by country. Object value contains, \"status\", and \"names\" as an array.",
"properties": {
"names": {
"type": "array",
"items": {
"type": "string"
}
},
"status": {
"type": "string"
}
},
"type": "object"
},
"dmarc_record": {
"type": "boolean",
"description": "Confirms if the domain has a proper DMARC DNS record."
},
"user_activity": {
"type": "string",
"description": "Frequency at which this email address makes legitimate purchases, account registrations, and engages in legitimate user behavior online. Values can be \"high\", \"medium\", \"low\", or \"none\". Values of \"high\" or \"medium\" are strong signals of healthy usage. New email addresses without a history of legitimate behavior will have a value as \"none\"."
},
"risky_tld": {
"type": "boolean",
"description": "Signals that the domain belongs to a risky TLD extension frequently associated with malware, scams, abuse, or phishing."
},
"sanitized_email": {
"type": "string",
"description": "Sanitized email address with all aliases and masking removed, such as multiple periods for Gmail.com."
},
"catch_all": {
"type": "boolean",
"description": "Is this email likely to be a \"catch all\" where the mail server verifies all emails tested against it as valid? It is difficult to determine if the address is truly valid in these scenarios, since the email's server will not confirm the account's status."
},
"first_name": {
"type": "string",
"description": "Suspected first name based on email. Returns \"CORPORATE\" if the email is suspected of being a generic company email. Returns \"UNKNOWN\" if the first name was not determinable."
},
"valid": {
"type": "boolean",
"descrption": "Does this email address appear valid?"
},
"request_id": {
"type": "string",
"description": "A unique identifier for this request."
},
"associated_phone_numbers": {
"description": "Displays phone numbers linked to the email address, if available. Match rates vary by country. Object value contains, \"status\", and \"phone_numbers\" as an array.",
"required": [
],
"properties": {
"phone_numbers": {
"type": "array",
"items": {
"type": "string"
}
},
"status": {
"type": "string"
}
},
"type": "object"
},
"spam_trap_score": {
"type": "string",
"description": "Intelligent confidence level of the email address being an active SPAM trap. Values can be \"high\", \"medium\", \"low\", or \"none\". We recommend scrubbing emails with a \"high\" status, typically for any promotional mailings. This data is meant to provide a more accurate result for the \"frequent_complainer\" and \"honeypot\" data points, which collect data from spam complaints, spam traps, and similar techniques."
},
"leaked": {
"type": "boolean",
"description": "Was this email address associated with a recent database leak from a third party? Leaked accounts pose a risk as they may have become compromised during a database breach."
},
"deliverability": {
"type": "string",
"description": "How likely is this email to be delivered to the user and land in their mailbox. Values can be \"high\", \"medium\", or \"low\"."
},
"frequent_complainer": {
"type": "boolean",
"description": "Indicates if this email frequently unsubscribes from marketing lists or reports spam complaints."
},
"domain_trust": {
"type": "string",
"description": "Risk classification of the email's domain based on past abuse issues and positive behavior signals. Values include: \"trusted\", \"positive\", \"neutral\", \"suspicious\", \"malicious\", or \"not rated\"."
},
"first_seen": { "required": [
],
"properties": {
"iso": {
"type": "string",
"description": "The time this email was first analyzed in ISO8601 format (Ex: 2019-09-09T16:40:34-04:00)"
},
"timestamp": {
"type": "integer",
"description": "The unix time since epoch when this email was first analyzed. (Ex: 1568061634)"
},
"human": {
"type": ["string", "null"],
"description": "A human description of the email address age, using an estimation of the email creation date this email address was first discovered. (Ex: 3 months ago)"
}
},
"type": "object"
},
"message": {
"type": "string",
"description": "A generic status message, either success or some form of an error notice."
},
"fraud_score": {
"type": "float",
"description": "The overall Fraud Score of the user based on the email's reputation and recent behavior across the threat network. Fraud Scores >= 75 are suspicious, but not necessarily fraudulent."
},
"overall_score": {
"type": "integer",
"description": "Overall email validity score. Range: 0 to 4. Scores above 1 can be associated with a valid email. 0 = invalid email address. 1 = dns valid, unreachable mail server. 2 = dns valid, temporary mail rejection error. 3 = dns valid, accepts all mail. 4 = dns valid, verified email exists."
},
"success": {
"type": "boolean",
"description": "Was the request successful?"
},
"timed_out": {
"type": "boolean",
"description": "Did the email verification connection to the mail service provider timeout during the verification?"
},
"dns_valid": {
"type": "boolean",
"description": "Does the email's hostname have valid DNS entries? Partial indication of a valid email."
},
"suspect": {
"type": "boolean",
"description": "This value indicates if the mail server is currently replying with a temporary mail server error or if the email verification system is unable to verify the email address due to a broken SMTP handshake. This status will also be true for \"catch all\" email addresses as defined below. If this value is true, then we suspect the \"valid\" result may be tainted and there is not a guarantee that the email address is truly valid. This status is rarely true for popular mailbox providers and typically only returns as true for a small percentage of business mail servers."
},
"domain_velocity": {
"type": "string",
"description": "Indicates the level of legitimate users interacting with the email address domain. Values can be \"high\", \"medium\", \"low\", or \"none\". Domains like \"IBM.com\", \"Microsoft.com\", \"Gmail.com\", etc. will have \"high\" scores as this value represents popular domains. New domains or domains that are not frequently visited by legitimate users will have a value as \"none\"."
},
"spf_record": {
"type": "boolean",
"description": "Confirms if the domain has a proper SPF DNS record."
},
"recent_abuse": {
"type": "boolean",
"description": "This value will indicate if there has been any recently verified abuse for this email address. Abuse could be a confirmed chargeback, fake signup, compromised device, fake app install, or similar malicious behavior within the past few days."
},
"honeypot": {
"type": "boolean",
"description": "Is this email believed to be a \"honeypot\" or \"SPAM trap\"? Bulk mail sent to these emails increases your risk of being blocklisted by large ISPs & ending up in the spam folder."
},
"mx_records": {
"type": "array",
"description": "List of MX records associated with the email's domain name.",
"items": {
"type": "string"
}
},
"common": {
"type": "boolean",
"description": "Is this email from common free email providers? (\"gmail.com\", \"yahoo.com\", \"hotmail.com\", etc.)"
},
"generic": {
"type": "boolean",
"description": "Is this email suspected as being a catch all or shared email for a domain? (\"admin@\", \"webmaster@\", \"newsletter@\", \"sales@\", \"contact@\", etc.)"
}
},
"type": "object"
},
"message": {
"type": "string"
},
"result": {
"type": "boolean"
},
"success": {
"type": "boolean"
}
}
}
}
Updated 17 days ago