Real-Time Email Validation API

<script type="text/javascript" src="path/to/jquery"></script>
<script type="text/javascript">
$(document).ready(function() {
    ...
    // send API request
    $.ajax({
        url: 'https://api.email-validator.net/api/verify',
        type: 'POST',
        cache: false,
        crossDomain: true,
        data: { EmailAddress: 'email address', APIKey: 'your API key' },
        dataType: 'json',
        success: function (json) {
            // check API result
            if (typeof(json.status) != "undefined") {
                var resultcode = json.status;
                if (typeof(json.info) != "undefined") {
                    // short summary
                    info = json.info;
                } else info = "";
                if (typeof(json.details) != "undefined") {
                    // detailed description
                    details = json.details;
                } else details = "";
                // resultcode 200, 207, 215 - valid
                // resultcode 215 - can be retried to update catch-all status
                // resultcode 114 - greylisting, wait 5min and retry
                // resultcode 118 - api rate limit, wait 5min and retry
                // resultcode 3xx/4xx - bad
            }
        }
    });
});
</script>

// build API request
$APIUrl = 'https://api.email-validator.net/api/verify';
$Params = array('EmailAddress' => 'email address', 'APIKey' => 'your API key');
$Request = http_build_query($Params, '', '&');
$ctxData = array(
    'method'=>"POST",
    'header'=>"Connection: close\r\n".
    "Content-Type: application/x-www-form-urlencoded\r\n".
    "Content-Length: ".strlen($Request)."\r\n",
    'content'=>$Request);
$ctx = stream_context_create(array('http' => $ctxData));

// send API request
$result = json_decode(file_get_contents($APIUrl, false, $ctx));

// check API result
if ($result && $result->{'status'} > 0) {
    switch ($result->{'status'}) {
        // valid addresses have a {200, 207, 215} result code
        // result codes 114 and 118 need a retry
        case 200:
        case 207:
        case 215:
            echo "Address is valid.";
            // 215 - can be retried to update catch-all status
            break;
        case 114:
            // greylisting, wait 5min and retry
            break;
        case 118:
            // api rate limit, wait 5min and retry
            break;
        default:
            echo "Address is invalid.";
            echo $result->{'info'};
            echo $result->{'details'};
            break;
    }
} else {
    echo $result->{'info'};
}

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.HttpClient;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.message.BasicNameValuePair;

import org.apache.http.util.EntityUtils;
import org.json.simple.JSONObject;
import org.json.simple.parser.JSONParser;
import org.json.simple.parser.ParseException;

HttpClient client = new DefaultHttpClient();
String Email = "email address";
String APIKey = "your API key";
String APIURL = "https://api.email-validator.net/api/verify";

try {
    HttpPost request = new HttpPost(APIURL);
    List <NameValuePair> Input = new ArrayList<NameValuePair>();
    Input.add(new BasicNameValuePair("EmailAddress", Email));
    Input.add(new BasicNameValuePair("APIKey", APIKey));
    request.setEntity(new UrlEncodedFormEntity(Input));
    HttpResponse response = client.execute(request);
    HttpEntity entity = response.getEntity();
    String Output = EntityUtils.toString(entity, "UTF-8");
    JSONParser parser = new JSONParser();
    Object obj = parser.parse(Output);
    JSONObject jsonObject = (JSONObject) obj;
    Long result = (Long) jsonObject.get("status");
    // result 200, 207, 215 - valid
    // result 215 - can be retried to update catch-all status
    // result 114 - greylisting, wait 5min and retry
    // result 118 - api rate limit, wait 5min and retry
    // result 3xx/4xx - bad
    String info = (String) jsonObject.get("info");
    String details = (String) jsonObject.get("details");
} catch (IOException e) {
    e.printStackTrace();
} catch (ParseException e) {
    e.printStackTrace();
} finally {
    client.getConnectionManager().shutdown();
}

using System;
using System.Collections.Generic;
using System.Net.Http;

private class APIResult
{
    public int status { get; set; }
    public String info { get; set; }
    public String details { get; set; }
}

const String APIURL = "https://api.email-validator.net/api/verify";
HttpClient client = new HttpClient();
String Email = "email address";
String APIKey = "your API key";

var postData = new List<KeyValuePair<string, string>>();
postData.Add(new KeyValuePair<string, string>("EmailAddress", Email));
postData.Add(new KeyValuePair<string, string>("APIKey", APIKey));

HttpContent content = new FormUrlEncodedContent(postData);

HttpResponseMessage result = client.PostAsync(APIURL, content).Result;
string resultContent = result.Content.ReadAsStringAsync().Result;

APIResult res = new System.Web.Script.Serialization.JavaScriptSerializer().
Deserialize<APIResult>(resultContent);

switch (res.status) {
    // valid addresses have a {200, 207, 215} result code
    // result codes 114 and 118 need a retry
    case 200:
    case 207:
    case 215:
        // address is valid
        // 215 - can be retried to update catch-all status
        break;
    case 114:
        // greylisting, wait 5min and retry
        break;
    case 118:
        // api rate limit, wait 5min and retry
        break;
    default:
        // address is invalid
        // res.info
        // res.details
        break;
}

Private Sub checkEmail(ByVal Email As String, ByVal APIKey As String)
    Const APIURL As String = "https://api.email-validator.net/api/verify"
    Using client As New Net.WebClient
        Dim postData As New Specialized.NameValueCollection
        postData.Add("EmailAddress", Email)
        postData.Add("APIKey", APIKey)
        Dim reply = client.UploadValues(APIURL, "POST", postData)
        Dim data As String = (New System.Text.UTF8Encoding).GetString(reply)
        Dim res = New System.Web.Script.Serialization.JavaScriptSerializer().
        Deserialize(Of APIResult)(data)
        Select Case (res.status)
            Case 200, 207, 215
            ' address is valid
            ' 215 - can be retried to update catch-all status
            Case 114, 118
            ' greylisting, wait 5min and retry
            Case 118
            ' api rate limit, wait 5min and retry
            Case Else
            ' address is invalid
        End Select
    End Using
End Sub

Private Class APIResult
    Public status As Integer
    Public info As String
    Public details As String
End Class