Real Email API

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.

Validate

This endpoint allows you to validate an email address.

> GET /api/email/validate?email=EMAIL_ADDRESS HTTP/1.1
> Host: isitarealemail.com
> Accept: application/json
> Authorization: bearer YOUR_API_KEY

< HTTP/1.1 200 OK
< Content-Type: application/json
< Content-Length: 20

{"status":"invalid"}

Curl

An example example using curl would look like this.

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

Parameters

Email

The email address is provided as a query parameter. This is the email address to validate. eg 'foo@bar.com'

Api Key

This is provided as the authorization http header. You can get your api key from the Real Email dashboard.

Your authentication token. eg Authorization: bearer xxxx where xxxx is your api key.

Response

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.