/v1/check_email

/v1/check_email

post

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.

Authorizations

Authorization

AuthorizationstringRequired

A Reacher API key is required for all requests. Sign up on https://reacher.email to get your personal API key.

Body

application/json

A request object to perform an email verification. The to_email field is required, all other fields are optional.

from_emailstringOptional

In the SMTP connection, the FROM email address.

to_emailstringRequired

The email address to check.

hello_namestringOptional

In the SMTP connection, the EHLO hostname.

smtp_portnumberOptional

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

gmail_verif_methodstring · enumOptional

Enumeration describing the method used to verify Gmail emails.

Possible values:

hotmailb2b_verif_methodstring · enumOptional

Enumeration describing the method used to verify Hotmail B2B emails.

Possible values:

hotmailb2c_verif_methodstring · enumOptional

Enumeration describing the method used to verify Hotmail B2C emails.

Possible values:

yahoo_verif_methodstring · enumOptional

Enumeration describing the method used to verify Yahoo emails.

Possible values:

check_gravatarbooleanOptional

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

Responses

200

OK

application/json

The result of the email verification process.

inputstring · emailRequired

The email address that was verified.

is_reachablestring · enumRequired

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://help.reacher.email/email-attributes-inside-json.

Possible values:

miscone ofRequired

Additional information about the email account.

or

mxone ofRequired

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

or

smtpone ofRequired

Results from connecting to the mail server via SMTP.

or

post

/v1/check_email

HTTPcURLJavaScriptPython

POST /v1/check_email HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 285

{
  "from_email": "text",
  "to_email": "text",
  "hello_name": "text",
  "proxy": {
    "host": "text",
    "port": 1,
    "username": "text",
    "password": "text"
  },
  "smtp_port": 1,
  "gmail_verif_method": "Smtp",
  "hotmailb2b_verif_method": "Smtp",
  "hotmailb2c_verif_method": "Smtp",
  "yahoo_verif_method": "Api",
  "check_gravatar": true
}

200

OK

{
  "input": "[email protected]",
  "is_reachable": "invalid",
  "misc": {
    "is_disposable": true,
    "is_role_account": true,
    "gravatar_url": "text",
    "is_b2c": true
  },
  "mx": {
    "accepts_mail": true,
    "records": [
      "text"
    ]
  },
  "smtp": {
    "can_connect_smtp": true,
    "has_full_inbox": true,
    "is_catch_all": true,
    "is_deliverable": true,
    "is_disabled": true
  },
  "syntax": {
    "domain": "text",
    "is_valid_syntax": true,
    "username": "text"
  },
  "debug": {
    "start_time": "text",
    "end_time": "text",
    "duration": {
      "secs": 1,
      "nanos": 1
    },
    "server_name": "text",
    "smtp": {
      "verif_method": {
        "type": "Smtp"
      }
    }
  }
}