Real Email API

The Real Email API documentation

The Real Email API is used to programmatically validate email addresses. It can be integrated with any system that can make http API calls. There are language specific examples for python, javascript, php, Java . Other ways to validate emails are using CSV files or Zapier.

get
Validate

https://isitarealemail.com/api/email/validate
This endpoint allows you to validate an email address.
Request
Response
Request
Headers
Authentication
required
string
Your authentication token. eg 'Bearer {{TOKEN}}'
Query Parameters
email
required
string
The email address you wish to validate. eg 'foo@bar.com'
Response
200: OK
The email address is valid
{
"status": "valid"
}

Validation Status Types

Status

Description

valid

The email address is valid.

invalid

The email address is invalid. It is either malformed, there is no mail server at the domain or the address does not exist on the server.

unknown

It cannot be determined if the email address exists in the mail server. This may happen if there is a mail server which is unresponsive. These validations are not charged.

Depending on your use case you may want to block or allow unknown's.

Curl

As an example a curl request would be.

curl 'https://isitarealemail.com/api/email/validate?email=foo@bar.com' \
-H 'Authorization: bearer xxxx'
{
"status": "valid"
}