Please enable JavaScript in your browser.

Introduction

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


** NOTE: We do not support Yahoo email validations at this moment. **

Request Parameters

Parameter Description
email (required) The email address to be validated.
key (required) API key.
format (optional) Return the result in json (default) or xml format.
Valid values: json | xml

Successful Response Parameters

Parameter Description
email_address The input email address.
base_email_address The input email address after sanitizing the username of the dots (only Gmail) and subaddressing.
domain The domain of the email address.
is_free 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 Whether the email address is syntactically correct.
Return values: true, false
is_domain Whether the email address has a valid MX record in its DNS entries.
Return values: true, false, null  (null means not applicable)
is_smtp Whether the mail servers specified in the MX records are responding to connections.
Return values: true, false, null  (null means not applicable)
is_verified 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 Whether the mail server is currently down or unresponsive.
Return values: true, false, null  (null means not applicable)
is_greylisted 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 Whether the email address is a temporary one from a disposable email provider.
Return values: true, false, null  (null means not applicable)
is_suppressed Whether the email address is in our blacklist.
Return values: true, false, null  (null means not applicable)
is_role 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 Whether the email address contains high risk keywords.
Return values: true, false, null  (null means not applicable)
is_catchall Whether the email address is a catch-all address.
Return values: true, false, null  (null means not applicable)
is_dmarc_enforced Whether the email domain is enforcing DMARC.
Return values: true, false
is_strict_spf Whether the email domain is using strict SPF.
Return values: true, false
website_exist Whether the email domain is a reachable website.
Return values: true, false
mailboxvalidator_score Email address reputation score. Score > 0.70 means good; score > 0.40 means fair; score ≤ 0.40 means poor.
time_taken The time taken to get the results in seconds.
status Whether our system think the email address is valid based on all the previous fields.
Return values: true, false
credits_available The number of credits left to perform validations.

Error Response Parameters

Parameter Description
error.error_code The error code if there is any error. See error table below.
error.error_message The error message if there is any error. See error table below.

Error Codes

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.

HTTP Error Codes

error_code HTTP Error
10000 400
10001 401
10002 401
10003 401
10004 401
10005 500

Single Email Validation API Sample Codes

<?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()