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.


This endpoint allows you to validate an email address.

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

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



An example example using curl would look like this.

curl '[email protected]' \
-H 'Authorization: bearer xxxx'
"status": "valid"



The email address is provided as a query parameter. This is the email address to validate. eg '[email protected]'

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.


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.