πŸ“¬
Email Attributes inside JSON
Last updated: January 31, 2021.

πŸ€“
This document describes the is_reachable field and other fields in Reacher's JSON API response.
Β 
Toggle here to see an example JSON response for someone@gmail.com (note that this email is disabled by Gmail).
{
	"input": "someone@gmail.com",
	"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:
  • The is_reachable field is an overall deliverability score. Checking this field should be preferred in 80% of the use cases.
  • All other fields give more details about the email address (Full inbox? Catch-all? DEA? etc.).

is_reachable field = Email deliverability

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.
  • 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.

Detailed deliverability in other fields

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.
  1. ✏️ Syntax Checks: Syntax checks ensure that the email meets certain basic criteria such as whether it contains the "@" symbol within the email address.
  1. 🌐 Domain Name Checks: Domain checking ensures that the email address contains a valid internet domain name, and validates if the featured domain is configured to accept mail.
  1. βš™οΈ SMTP Checks: This function checks that the address segment before the β€˜@’ sign is a valid mailbox. This is the clever part, and what sets our service apart from many others.
  1. πŸ’‘ Misc Checks: This function checks some miscelleanous information about the email address. As of today, it only checks if the email address is disposable, but we're looking to add checks around whether the email provider is free or not, if it's an role-based email address, or if it has been compromised in data breaches.

1. Syntax Checks

Syntax checks ensure that the email meets certain basic criteria such as whether it contains the "@" symbol within the email address.
✏️Which syntax checks are performed?

2. Domain Name Checks

Domain checking ensures that the email address contains a valid internet domain name, and validates if the featured domain is configured to accept mail.
🌐Which domain checks are performed?
json.mx.accepts_mail
json.mx.records

3. SMTP Checks

This function checks that the address is a valid mailbox. This is the clever part, and what sets Reacher apart from many others.
βš™οΈWhich SMTP checks are performed?
json.smtp.is_deliverable
json.smtp.is_catch_all
json.smtp.is_disabled
json.smtp.has_full_inbox

4. Miscelleanous Checks

πŸ’‘Which misc checks are performed?

OpenAPI Documentation

Head to the πŸ“–REST API Documentation to see the full API reference as well as Reacher's OpenAPI specification.