Status | the request status. 200 if successful (see error responses below) |
requestId | an arbitrary request ID string for debugging |
unknownEmails | an array of emails that cannot be verified due to configuration on the email server, or because the email server took too long to respond. Retryable but not guaranteed to be successful if requested again. |
failedEmails | an array of emails that cannot be verified due to an unknown error. Retryable but not guaranteed to be successful if requested again. |
emails | a JSON object with all successful results of this email verification call. Each key is the email queried, and the associated object is the associated data. Only one field will be present in the single-email endpoint. The batch endpoint will have multiple fields (one for each email successfully processed). |
message | A displayable string describing the state of the email. |
address | The email address that was processed. This is usually the queried email. However, if email auto-correct was able to detect an error, it will correct the email to this new format (e.g. “fullcontact.ocm” to “fullcontact.com” in the example response). If this occurs, the corrected field will be true. |
username | the inbox/username of the email. |
domain | the domain hosting the email address. |
corrected | true if the email auto-correct feature has made a change to the email. See address. |
sendSafely | An aggregate of the attributes object. If true, to the best of our knowledge, an email sent to this email address will deliver to a real person and will not be used for malicious purposes. |
attributes | a set of lower-level attributes for fine-grained understanding of the state of this email |
validSyntax | the email address conforms to the most common interpretations of valid email address syntax (e.g. there is only one unescaped “@” symbol). |
deliverable | emails sent to this email address will not be bounced by the mail server. They will get delivered to some inbox. |
catchall | the email server is configured to accept all emails at this domain even if the email address it is addressed to does not exist. This can make it hard to determine if an email address is actually valid, since a fake email hosted at this domain looks the same as a real email hosted at this domain. |
risky | this email address is registered as a spamtrap or is associated with behavior where we do not recommend emailing it. |
disposable | this email address is disposable. It may be a real email, but the recipient does not own it for long. (e.g. 10minutemail.com) |
person | a link to the person API profile for this email. |
company | a link to the company API profile for this email domain. Not present for email addresses provided by free email services (e.g. yahoo, google...) |