/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

post

/v1/check_email

HTTPcURLJavaScriptPython

POST /v1/check_email HTTP/1.1
Host: api.reacher.email
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"
      }
    }
  }
}