/v1/check_email

/v1/check_email

Perform a comprehensive verification of an email address. This endpoint supersedes the previous /v0/check_email endpoint, maintaining the same input and output format. Unlike the /v0/check_email endpoint, the new /v1/check_email endpoint queues the email for verification, and the Reacher server processes the queue based on its configuration settings such as throttle and concurrency.

POSThttps://api.reacher.email/v1/check_email

Body

application/json

Request object containing all parameters necessary for an email verification.

from_emailstring

In the SMTP connection, the FROM email address.

to_email*string

The email address to check.

hello_namestring

In the SMTP connection, the EHLO hostname.

proxyCheckEmailInputProxy

Proxy configuration for email verification.

smtp_portnumber

SMTP port to use for email validation. Defaults to 25, but 465, 587, and 2525 are sometimes also used.

gmail_verif_methodGmailVerifMethod

Enumeration describing the method used to verify Gmail emails.

ApiSmtp

hotmailb2b_verif_methodHotmailB2BVerifMethod

Enumeration describing the method used to verify Hotmail B2B emails.

Smtp

hotmailb2c_verif_methodHotmailB2CVerifMethod

Enumeration describing the method used to verify Hotmail B2C emails.

SmtpHeadlessApi

yahoo_verif_methodYahooVerifMethod

Enumeration describing the method used to verify Yahoo emails.

ApiHeadlessSmtp

check_gravatarboolean

Whether to check if a Gravatar image exists for the given email.

Response

200

OK

Body

application/json

input*string (email)

The email address that was verified.

is_reachable*Reachable

An enumeration describing the confidence level that the recipient address is valid: safe, risky, invalid, or unknown. Refer to our FAQ for detailed definitions: https://docs.reacher.email/getting-started/is-reachable.

invalidunknownsaferisky

misc*one of

Additional information about the email account.

MiscDetailsCoreError

mx*one of

Details obtained from querying the mail server's MX records.

MxDetailsCoreError

smtp*one of

Results from connecting to the mail server via SMTP.

SmtpDetailsCoreError

syntax*SyntaxDetails

Validation of the email address syntax.

debugDebugDetails

Request

JavaScriptCurlPython

const response = await fetch('https://api.reacher.email/v1/check_email', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "to_email": "text"
    }),
});
const data = await response.json();

Response

200

{
  "input": "[e-mail]",
  "is_reachable": "invalid",
  "misc": {
    "is_disposable": false,
    "is_role_account": false,
    "gravatar_url": "text"
  },
  "mx": {
    "accepts_mail": false,
    "records": [
      "text"
    ]
  },
  "smtp": {
    "can_connect_smtp": false,
    "has_full_inbox": false,
    "is_catch_all": false,
    "is_deliverable": false,
    "is_disabled": false
  },
  "syntax": {
    "domain": "text",
    "is_valid_syntax": false,
    "username": "text"
  },
  "debug": {
    "start_time": "text",
    "end_time": "text",
    "duration": {
      "secs": 0,
      "nanos": 0
    },
    "backend_name": "text",
    "smtp": {
      "verif_method": {
        "type": "Smtp"
      }
    }
  }
}