Frequently Asked Question

email - Validate an email address by doing actual delivery attempts and checking configuration

Last Updated 10 months ago

EmailValidate API

Overview

The EmailValidate API performs comprehensive validation of an email address, including syntax checking, domain verification, and SMTP server validation.

Version

1.000

Endpoint

/v2/email

Authentication

This API requires authentication using an API key. The key should be passed in the X_API_Key header.

Request Parameters

Parameter	Type	Description
e	string	Email address to validate (required)

Response

The API returns a JSON object with the following structure:

Field	Type	Description
status	string	The status of the request. "success" for successful requests, or an error message.
bad	integer	1 if the domain is in the bad email list, 0 otherwise.
free	integer	1 if the domain is in the free email list, 0 otherwise.
result	boolean	True if the email is valid according to SMTP validation, false otherwise.
code	string	The SMTP response code.
log	string	Detailed log of the SMTP validation process.
version	string	The version of the API.

Example Response


{
  "status": "success",
  "bad": 0,
  "free": 1,
  "result": true,
  "code": "250",
  "log": "Detailed SMTP validation log...",
  "version": "1.000"
}

Error Handling

If no email is provided: {"status": "No email provided"}
If the email format is invalid: {"validate": "FAIL", "status": "success"}
If there's an authentication error: {"status": "[validation status]"}

Apply

Notes

The API checks the email against lists of known bad and free email domains.
SMTP validation is performed by connecting to the email's domain MX servers.
The API uses a custom SMTP validation process that doesn't actually send an email.
The email address is converted to lowercase before processing.

Security

Ensure that the API key is kept secure and not exposed in client-side code.
All responses are sent with the "Content-Type: application/json" header.