Last updated: October 11th, 2023.
<aside>
🤓 This document describes the Reacher's JSON API response, including the is_reachable
field:
safe
invalid
risky
unknown
</aside>
Here is an example JSON response for [email protected]
(note that this email is disabled by Gmail):
{
"input": "[email protected]",
"is_reachable": "invalid",
"misc": {
"is_disposable": false,
"is_role_account": false
},
"mx": {
"accepts_mail": true,
"records": [
"alt3.gmail-smtp-in.l.google.com.",
"gmail-smtp-in.l.google.com.",
"alt1.gmail-smtp-in.l.google.com.",
"alt4.gmail-smtp-in.l.google.com.",
"alt2.gmail-smtp-in.l.google.com."
]
},
"smtp": {
"can_connect_smtp": true,
"has_full_inbox": false,
"is_catch_all": false,
"is_deliverable": false,
"is_disabled": true
},
"syntax": {
"domain": "gmail.com",
"is_valid_syntax": true,
"username": "someone"
}
}
The JSON fields can be categorized into 2 categories:
is_reachable
field is an overall deliverability score. Checking this field should be enough for most use cases.is_reachable
?For each email, Reacher gives a confidence score in terms of deliverability in the is_reachable
field. This field can take 4 values:
safe
: We guarantee a hard bounce rate lower than 2%. Bounce rates may still happen, because we connect to the email's SMTP server from a different IP address than you, and yours might be blacklisted.invalid
: We guarantee with a confidence of 99% that this email is not deliverable.risky
: The email address appears to exist, but has quality issues that may result in low engagement or a bounce. We don't recommend sending to these emails, and don't commit on an accuracy rate. An email is considered risky
when at least one of the following is true:
support@
or admin@
),unknown
: It might happen on rare occasions that the email provider doesn't allow real-time verification of emails. In this case, there's unfortunately nothing Reacher can do. Please let us know if this happens, we're working on finding ways to solve these issues, which in most occasions are solved on a case-by-case basis.If the 4 variants of the is_reachable
field is not enough for your use case, then you can look into the other fields, which provide more details about the email address.
When you input an email address, Reacher starts analyzing the email in 4 areas.
"syntax"
: Syntax checks ensure that the email meets certain basic criteria such as whether it contains the "@" symbol within the email address.