Reacher
  • Welcome to Reacher
  • Getting Started
    • Verify your 1st email
    • Understanding "is_reachable"
  • Self-Hosting
    • SaaS vs Self-Host
    • Install Reacher in 20min
    • Scaling for Production
      • Manage scaling yourself
      • Option 1: RabbitMQ-based Queue Architecture
    • Licensing
      • Commercial License Trial
    • Proxies
      • Multiple Proxies
    • Reacher Configuration
    • Debugging Reacher
  • Advanced
    • OpenAPI
      • /v0/check_email
      • /v1/check_email
      • /v1/bulk
    • Run your own Proxy
    • Migrations
      • Reacher Configuration (v0.10)
      • Migrating from 0.7 to 0.10
      • Bulk Verification (v0.7)
      • Docker Environment Variables (v0.7)
Powered by GitBook
On this page
  1. Advanced
  2. OpenAPI

/v1/check_email

Previous/v0/check_emailNext/v1/bulk

Last updated 4 months ago

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

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
POST /v1/check_email HTTP/1.1
Host: api.reacher.email
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 284

{
  "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

OK

{
  "input": "name@gmail.com",
  "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"
      }
    }
  }
}