Single Validation API

The Single Email Validation API does validation on a single email address and returns all the validation results in JSON format.

Response Parameters

Parameter

Type

Definition

"result"

[string]

The verified results will be: deliverable, undeliverable, unknown, accept-all

"message"

[string]

Describes API result

"email"

[email]

The email that was verified.

"user"

[string]

The user part of the provided email address.

"domain"

[string]

The domain of the provided email address.

"accept_all"

[Integer]

Remote host accepts mail at any address.

"role"

[0, 1]

Whether the email is considered a role address. (e.g. "[email protected], [email protected], [email protected], etc.)

"free_email"

[0, 1]

Whether the email is hosted by a free email provider like Gmail, Yahoo!, Hotmail etc..

"disposable"

[0, 1]

Whether this is a temporary email.

"spamtrap"

[0, 1]

Is this a honeytrap email

"success"

[true, false]

Whether the API request call was successful or not.

Other Responses

The response you get when the API key is invalid:

HTTP/1.1 401 Unauthorized
{   
   "success":"false",
   "result":"Invalid API Key"
}

The response you get when your credits have been used:

HTTP/1.1 402 Payment Required
{   
   "success":"false",
   "result":"Insufficient vrification credits"
}

The response you get when your call rate is high (more than 120 concurrent calls):

HTTP/ 429 Too Many Requests
{   
   "success":"false",
   "result":"Too many requests"
}
Language
Authentication
Response
Click Try It! to start a request and see the response here!