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. "sales@, info@, help@, 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:

JSON

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

The response you get when your credits have been used:

JSON

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

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

JSON

HTTP/ 429 Too Many Requests
{   
   "success":"false",
   "result":"Too many requests"
}