Api

Real Time API

Request Method : GET

Endpoint : https://emailvalidators.com/api/v1/single/check?api={api_key}&username={username}&email={email}&timeout=10

Parameters

Name	Type	Description	Required
api	String	The api key of your account	True
username	String	The username of your account	True
email	String	Email Address Which Need to verify	True
timeout	Number	Max Request validity time	True

Api Results

Name	Result
email	the email address you had tested
status	success|fail
result	Valid, CatchAll, Unknown, Disposable, Bounce
role	True|False, if true it indicates the email address is not directly linked to a person but a role, like sales, support...
error	(if status was fail) describes why the query failed, -Required parameter missing or invalid. -User authentication failed. Wrong API Key or username. -Email Format is not correct. -The request was refused due to insufficent credit.

Curl

curl --request GET 'https://emailvalidators.com/api/v1/single/check?api=your_api_key&username=your_username&email=sampleuser@example.com&timeout=10'

Java

OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
.url("https://emailvalidators.com/api/v1/single/check?api=your_api_key&username=your_username&email=sampleuser@example.com&timeout=10")
.method("GET", null)
.build();
Response response = client.newCall(request).execute();

Php

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://emailvalidators.com/api/v1/single/check?api=your_api_key&username=your_username&email=sampleuser@example.com&timeout=10');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}

Python

import http.client
import mimetypes
conn = http.client.HTTPSConnection("emailvalidators.com")
payload = {}
headers = {}
conn.request("GET", "/api/v1/single/check?api=your_api_key&username=your_username&email=sampleuser@example.com&timeout=10", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Nodejs

var request = require('request');
var options = {
'method': 'GET',
'url': 'https://emailvalidators.com/api/v1/single/check?api=your_api_key&username=your_username&email=sampleuser@example.com&timeout=10',
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});

File Transfer API

Upload & Process Files

Request Method : GET

Endpoint : https://emailvalidators.com/api/v1/jobs/create?api={api_key}&username={username}&file_name={remote_url}&timeout=10

Parameters

Name	Type	Description	Required
api	String	The api key of your account	True
username	String	The username of your account	True
file_name	String	Downloadable remote hosted file	True
timeout	Number	Max Request validity time	True

Api Results (Json)

Name	Result
status	success|fail
job_id	a unique id to access job result in future
error	(if status was fail) describes why the query failed, - Required parameter missing or invalid. - User authentication failed. Wrong API Key or username. - The request was refused due to insufficent credit. - File is not downloadable. - File Format is not correct.

Curl

curl --request GET 'https://emailvalidators.com/api/v1/jobs/create?api=your_api_key&username=your_username&file_name=remote_file_url&timeout=10'

Java

OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
  .url("https://emailvalidators.com/api/v1/jobs/create?api=your_api_key&username=your_username&file_name=remote_file_url&timeout=10")
  .build();
Response response = client.newCall(request).execute();

Php

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://emailvalidators.com/api/v1/jobs/create?api=your_api_key&username=your_username&file_name=remote_file_url&timeout=10');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Python

import requests

url = "https://emailvalidators.com/api/v1/jobs/create?api=your_api_key&username=your_username&file_name=remote_file_url&timeout=10"
payload = {}
headers = {}
response = requests.request("GET", url, headers=headers, data = payload)
print(response.text.encode('utf8'))

NODEJS

var request = require('request');
var options = {
'method': 'GET',
'url': 'https://emailvalidators.com/api/v1/jobs/create?api=your_api_key&username=your_username&file_name=remote_file_url&timeout=10',
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});

Check Status

Request Method : GET

Endpoint : https://emailvalidators.com/api/v1/jobs/status?api={api_key}&username={username}&job_id={job_id}

PARAMETERS

Name	Type	Description	Required
api	String	The api key of your account	True
username	String	The username of your account	True.
job_id	Number	JobId to check status	True

Api Results (Json)

Name	Result
status	success|processing|fail
error	(if status was fail) describes why the query failed, - This Job Id not associated to your users. - Required parameter missing or invalid - User authentication failed. Wrong API Key or username.

Curl

curl --request GET 'https://emailvalidators.com/api/v1/jobs/status?api=your_api_key&username=your_username&job_id=your_job_id'

Java

OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
  .url("https://emailvalidators.com/api/v1/jobs/status?api=your_api_key&username=your_username&job_id=your_job_id")
  .method("GET", null)
  .build();
Response response = client.newCall(request).execute();

Php

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://emailvalidators.com/api/v1/jobs/status?api=your_api_key&username=your_username&job_id=your_job_id');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));

try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Python

import requests

url = "https://emailvalidators.com/api/v1/jobs/status?api=your_api_key&username=your_username&job_id=your_job_id"

payload = {}
headers = {}
response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

NODEJS

var request = require('request');
var options = {
'method': 'GET',
'url': 'https://emailvalidators.com/api/v1/jobs/status?api=your_api_key&username=your_username&job_id=your_job_id',
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});

Download Results

Request Method : GET

Endpoint : https://emailvalidators.com/api/v1/jobs/download?api={api_key}&username={username}&job_id={job_id}

Parameters

NAME	Type	Description	Required
api	String	The api key of your account	True
username	String	The username of your account	True
job_id	Number	JobId to download results	True

Api Results (Json)

Name	Result
status	success|fail
result	It will return emaillist.csv file with "Email","Name","Status","Role Based Emails" columns.
error	(if status was fail) describes why the query failed, - This Job Id not associated to your users. - List is currently Processing. Please wait some times. - Required parameter missing or invalid - User authentication failed. Wrong API Key or username.

Curl

curl --request GET 'https://emailvalidators.com/api/v1/jobs/download?api=your_api_key&username=your_username&job_id=your_job_id'

Java

OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
  .url("https://emailvalidators.com/api/v1/jobs/download?api=your_api_key&username=your_username&job_id=your_job_id")
  .method("GET", null).build();
Response response = client.newCall(request).execute();

Php

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://emailvalidators.com/api/v1/jobs/download?api=your_api_key&username=your_username&job_id=your_job_id');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

Python

import requests

url = "https://emailvalidators.com/api/v1/jobs/download?api=your_api_key&username=your_username&job_id=your_job_id"

payload = {}
headers = {}
response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

Nodejs

var request = require('request');
var options = {
'method': 'GET',
'url': 'https://emailvalidators.com/api/v1/jobs/download?api=your_api_key&username=your_username&job_id=your_job_id',
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});