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

post

/v1/check_email

Authorizations

Body

from_emailstring

In the SMTP connection, the FROM email address.

to_emailstringrequired

The email address to check.

hello_namestring

In the SMTP connection, the EHLO hostname.

proxyobject

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_methodstring · enum

Enumeration describing the method used to verify Gmail emails.

Options: Api, Smtp

hotmailb2b_verif_methodstring · enum

Enumeration describing the method used to verify Hotmail B2B emails.

Options: Smtp

hotmailb2c_verif_methodstring · enum

Enumeration describing the method used to verify Hotmail B2C emails.

Options: Smtp, Headless, Api

yahoo_verif_methodstring · enum

Enumeration describing the method used to verify Yahoo emails.

Options: Api, Headless, Smtp

check_gravatarboolean

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

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.reacher.email/v1/check_email' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "from_email": "text",
    "to_email": "text",
    "hello_name": "text",
    "proxy": {
      "host": "text",
      "port": 1,
      "username": "text",
      "password": "text"
    },
    "smtp_port": 1,
    "gmail_verif_method": "Api",
    "hotmailb2b_verif_method": "Smtp",
    "hotmailb2c_verif_method": "Smtp",
    "yahoo_verif_method": "Api",
    "check_gravatar": true
  }'

200

200

{
  "input": "[e-mail]",
  "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"
      }
    }
  }
}

OK