v1

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

/v0/check_email

Sunset notice: please use /v1/check_email instead. Both endpoints accept the same input arguments and return the same output; only their internal implementation differs. Perform a comprehensive verification of an email address. Unlike the /v1/check_email endpoint, this endpoint performs an email verification immediately, without considering the Reacher server's throttling, concurrency, and other configurations. As such, this endpoint is slightly riskier than /v1/check_email, as the Reacher server's IP reputation can be impacted if this endpoint is called too frequently.

post/v0/check_email

Headers

Authorizationstring required

Your personal Reacher API key

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.