Single Validation API

get https://api.validto.com/v1/verify

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:

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 verification 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"
}

Response

Language

Request


xxxxxxxxxx
11
1
var request = require('request');
2
var options = {
3
  'method': 'GET',
4
  // Replace API_KEY with your API Key
5
  'url': 'https://api.validto.com/v1/verify?apikey=API_KEY&email=test@example.com',
6
  'headers': {}
7
};
8
request(options, function (error, response) {
9
  if (error) throw new Error(error);
10
  console.log(response.body);
11
});

Click Try It! to start a request and see the response here! Or choose an example:

application/json