Sign in

v1

latestOpenAPI 3.0.0AGPL-3.0 OR Commercial2026-07-1751922.3 KB

/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

Request body

from_emailstring

In the SMTP connection, the FROM email address.

to_emailstring required

The email address to check.

hello_namestring

In the SMTP connection, the EHLO hostname.

smtp_portnumber

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

gmail_verif_method'Smtp'

Enumeration describing the method used to verify Gmail emails.

hotmailb2b_verif_method'Smtp'

Enumeration describing the method used to verify Hotmail B2B emails.

hotmailb2c_verif_method'Smtp' | 'Headless'

Enumeration describing the method used to verify Hotmail B2C emails.

yahoo_verif_method'Api' | 'Headless' | 'Smtp'

Enumeration describing the method used to verify Yahoo emails.

check_gravatarboolean

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

Response

OK

inputstring email required

The email address that was verified.

is_reachable'invalid' | 'unknown' | 'safe' | 'risky' required

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.

All 5 operations