The Single Email Validation API does validation on a single email address and returns all the validation results in either JSON or XML format.
NOTE: You will get your API key when you sign up for any MailboxValidator API plans.
Go to your dashboard to retrieve your API key.
GET https://api.mailboxvalidator.com/v2/validation/single
Parameter | Type | Description |
---|---|---|
string | (required) The email address to be validated. | |
key | string | (required) API key. |
format | string |
(optional) Return the result in json (default) or xml format. Valid values: json | xml |
Parameter | Type | Description |
---|---|---|
email_address | string | The input email address. |
base_email_address | string | The input email address after sanitizing the username of the dots (only Gmail) and subaddressing. |
domain | string | The domain of the email address. |
is_free | boolean | Whether the email address is from a free email provider like Gmail or Hotmail. Return values: true, false, null (null means not applicable) |
is_syntax | boolean | Whether the email address is syntactically correct. Return values: true, false |
is_domain | boolean | Whether the email address has a valid MX record in its DNS entries. Return values: true, false, null (null means not applicable) |
is_smtp | boolean | Whether the mail servers specified in the MX records are responding to connections. Return values: true, false, null (null means not applicable) |
is_verified | boolean | Whether the mail server confirms that the email address actually exist. Return values: true, false, null (null means not applicable or unable to perform verification) |
is_server_down | boolean | Whether the mail server is currently down or unresponsive. Return values: true, false, null (null means not applicable) |
is_greylisted | boolean | Whether the mail server employs greylisting where an email has to be sent a second time at a later time. Return values: true, false, null (null means not applicable) |
is_disposable | boolean | Whether the email address is a temporary one from a disposable email provider. Return values: true, false, null (null means not applicable) |
is_suppressed | boolean | Whether the email address is in our blacklist. Return values: true, false, null (null means not applicable) |
is_role | boolean | Whether the email address is a role-based email address like admin@example.net or webmaster@example.net. Return values: true, false, null (null means not applicable) |
is_high_risk | boolean | Whether the email address contains high risk keywords. Return values: true, false, null (null means not applicable) |
is_catchall | boolean | Whether the email address is a catch-all address. Return values: true, false, null (null means not applicable) |
is_dmarc_enforced | boolean | Whether the email domain is enforcing DMARC. Return values: true, false |
is_strict_spf | boolean | Whether the email domain is using strict SPF. Return values: true, false |
website_exist | boolean | Whether the email domain is a reachable website. Return values: true, false |
mailboxvalidator_score | float | Email address reputation score. Score > 0.70 means good; score > 0.40 means fair; score ≤ 0.40 means poor. |
time_taken | float | The time taken to get the results in seconds. |
status | boolean | Whether our system think the email address is valid based on all the previous fields. Return values: true, false |
credits_available | integer | The number of credits left to perform validations. |
Parameter | Type | Description |
---|---|---|
error.error_code | integer | The error code if there is any error. See error table below. |
error.error_message | string | The error message if there is any error. See error table below. |
error_code | error_message |
---|---|
10000 | Missing parameter. |
10001 | API key not found. |
10002 | API key disabled. |
10003 | API key expired. |
10004 | Insufficient credits. |
10005 | Unknown error. |
error_code | HTTP Error |
---|---|
10000 | 400 |
10001 | 401 |
10002 | 401 |
10003 | 401 |
10004 | 401 |
10005 | 500 |
<?php
$apiKey = 'Enter_License_Key';
$params['format'] = 'json';
$params['email'] = 'Enter_Email';
$query = '';
foreach($params as $key=>$value){
$query .= '&' . $key . '=' . rawurlencode($value);
}
$try = 0;
do {
////////////
//For https request, please make sure you have enabled php_openssl.dll extension.
//
//How to enable https
//- Uncomment ;extension=php_openssl.dll by removing the semicolon in your php.ini, and restart the apache.
//
//In case you have difficulty to modify the php.ini, you can always make the http request instead of https.
////////////
$result = file_get_contents('https://api.mailboxvalidator.com/v2/validation/single?key=' . $apiKey . $query);
} while(!$result && $try++ < 3);
$data = json_decode($result);
print_r($data);
?>
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
import java.net.URLEncoder;
import java.util.Hashtable;
import java.util.Map;
public class test {
public static void main(String[] args) {
try {
String key = "Enter_License_Key";
Hashtable<String, String> data = new Hashtable<String, String>();
data.put("format", "json");
data.put("email", "Enter_Email");
String datastr = "";
for (Map.Entry<String,String> entry : data.entrySet()) {
datastr += "&" + entry.getKey() + "=" + URLEncoder.encode(entry.getValue(), "UTF-8");
}
URL url = new URL("https://api.mailboxvalidator.com/v2/validation/single?key=" + key + datastr);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("Accept", "application/json");
if (conn.getResponseCode() != 200) {
throw new RuntimeException("Failed : HTTP error code : " + conn.getResponseCode());
}
BufferedReader br = new BufferedReader(new InputStreamReader((conn.getInputStream())));
String output;
while ((output = br.readLine()) != null) {
System.out.println(output);
}
conn.disconnect();
}
catch (MalformedURLException e) {
e.printStackTrace();
}
catch (IOException e) {
e.printStackTrace();
}
}
}
Imports System.Net
Imports System.IO
Imports System.Uri
Public Class _Default
Inherits System.Web.UI.Page
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
Dim request As HttpWebRequest = Nothing
Dim response As HttpWebResponse = Nothing
Dim apiKey As String = "Enter_License_Key"
Dim data As New Dictionary(Of String, String)
data.Add("format", "json")
data.Add("email", "Enter_Email")
Dim datastr As String = String.Join("&", data.[Select](Function(x) x.Key & "=" & EscapeDataString(x.Value)).ToArray())
request = Net.WebRequest.Create("https://api.mailboxvalidator.com/v2/validation/single?key=" & apiKey & "&" & datastr)
request.Method = "GET"
response = request.GetResponse()
Dim reader As System.IO.StreamReader = New IO.StreamReader(response.GetResponseStream())
Page.Response.Write(reader.ReadToEnd)
End Sub
End Class
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Net;
using System.IO;
namespace WebApplication1
{
public partial class _Default : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
WebRequest request = null;
WebResponse response = null;
string apiKey = "Enter_License_Key";
Dictionary<string, string> data = new Dictionary<string, string>();
data.Add("format", "json");
data.Add("email", "Enter_Email");
string datastr = string.Join("&", data.Select(x => x.Key + "=" + System.Uri.EscapeDataString(x.Value)).ToArray());
request = System.Net.WebRequest.Create("https://api.mailboxvalidator.com/v2/validation/single?key=" + apiKey + "&" + datastr);
request.Method = "GET";
response = request.GetResponse();
System.IO.StreamReader reader = new System.IO.StreamReader(response.GetResponseStream());
Page.Response.Write(reader.ReadToEnd());
}
}
}
import httplib
import urllib
import hashlib
p = { 'key': 'Enter_License_Key', 'format': 'json', 'email': 'Enter_Email' }
conn = httplib.HTTPConnection("api.mailboxvalidator.com")
conn.request("GET", "/v2/validation/single?" + urllib.urlencode(p))
res = conn.getresponse()
print res.read()