ZeroBounce Email Validation API

Ready to prevent unwanted sign-ups?

What is Email Validation API?

ZeroBounce email validation API is a simple but powerful tool that opens up a world of possibilities for your company to validate any email address. The API provides you with a 360-degree report view of your email list, covering over 30 status and sub-status codes, which will help you make the right decision on whether to email a certain address.

Stop unwanted sign-ups with our Email Validation API

When a customer signs up to your website or to your newletter, you will call the API to get a valuable information about that email address. This allows you to make actionable decisions based on the results.

  • Is the email domain mis-spelled?

    • Check the sub_status property for "possible_typo" and provide them the suggestion in the did_you_mean property.

    "Your email address "example@gnail.com" is invalid, did you mean "example@gmail.com"?
  • Is it a temporary email address?

    • Check the sub_status property for "disposable".

    "Thanks for your interest in our newsletter, but we don't accept temporary email addresses. Please use your real email address.
  • Is the email address invalid?

    • Check the status property for "invalid".

    "It appears that your email address is invalid, please double check the spelling."
  • Do you only accept corporate emails?

    • Check the free_email property for "true".

    "We only allow corporate customers, please sign up with your corporate email account."
  • Do you only accept personal emails?

    • Check the sub-status property for "role_based".

    "Please use your personal email account, we don't allow emails that start with "admin, sales, website, etc".
  • Having issues with fraud?

    • Check the domain_age_days property.

    "We don't allow sign-ups from brand new domains."

You're in complete control with all the intelligence you need to make the right decisions for your company, with the rich data set returned by the API.

You are in full control with our Email Validation API Dashboard

The Email Validation API Dashboard tracks your usage in real-time and provides you the overall health of your email validations. The dashboard provides you daily and monthly views with a selectable time-range.

  • Daily and monthly views with selectable date ranges.
  • Four different detail reports for by each status code (All, Invalids, Do Not Mail, and Unknown) broken down by sub-status.
  • Interactive graphs, just hover over the points on the graph to get counts and more information.
  • Click on the status or sub-status in the legend to filter the chart to see only the data you want.
email validation api usage

How do I integrate the email validation API?

You can easily integrate our lightning fast validation API into your website or application, with only a few lines of code. Use our API Sandbox to test your implementation for all the different Email Validation Status Codes .

Get the .NET API Wrapper V2 from GitHub.
var zeroBounceAPI = new ZeroBounce.ZeroBounceAPI();
zeroBounceAPI.api_key = "Your API Key";
zeroBounceAPI.emailToValidate = "flowerjill@aol.com";
zeroBounceAPI.ip_address = "99.110.204.1"; //Optional

var apiProperties = zeroBounceAPI.ValidateEmail();

//use the properties to make decisions on
switch (apiProperties.status)
   {
   case "invalid":
      Console.WriteLine("invalid");
      break;
    case "valid":
      Console.WriteLine("valid");
      break;
    default:
      Console.WriteLine(apiProperties.status);
      break;
   }
Response
{
   "address": "flowerjill@aol.com",
   "status": "valid",
   "sub_status": ",
   "free_email": true,
   "did_you_mean": null,
   "account": "flowerjill",
   "domain": "aol.com",
   "domain_age_days": "8426",
   "smtp_provider": "yahoo",
   "mx_record": "mx-aol.mail.gm0.yahoodns.net",
   "mx_found": true,
   "firstname": "Jill",
   "lastname": "Stein",
   "gender": "female",
   "country": "United States",
   "region": "Florida",
   "city": "West Palm Beach",
   "zipcode": "33401",
   "processed_at": "2017-04-01 02:48:02.592"
}
Get the PHP API Wrapper V2 from GitHub.
<?php
// use curl to make the request
$url = 'https://api.zerobounce.net/v2/validate?api_key=YOUR_API_KEY&email=' . urlencode('flowerjill@aol.com') . '&ip_address=' . urlencode('99.110.204.1');

//PHP 5.5.19 and higher has support for TLS 1.2
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_SSLVERSION, 6);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 15);
curl_setopt($ch, CURLOPT_TIMEOUT, 150);
$response = curl_exec($ch);
curl_close($ch);

//decode the json response
$json = json_decode($response, true);
?>
Response
{
   "address": "flowerjill@aol.com",
   "status": "valid",
   "sub_status": ",
   "free_email": true,
   "did_you_mean": null,
   "account": "flowerjill",
   "domain": "aol.com",
   "domain_age_days": "8426",
   "smtp_provider": "yahoo",
   "mx_record": "mx-aol.mail.gm0.yahoodns.net",
   "mx_found": true,
   "firstname": "Jill",
   "lastname": "Stein",
   "gender": "female",
   "country": "United States",
   "region": "Florida",
   "city": "West Palm Beach",
   "zipcode": "33401",
   "processed_at": "2017-04-01 02:48:02.592"
}
Get the Python API Wrapper V2 from GitHub.

from zerobounce import ZeroBounceAPI

zba = ZeroBounceAPI('YourApiKey')
print zba.get_credits()
resp1 = zba.validate('flowerjill@aol.com','99.110.204.1')
print resp1
Response
{
   "address": "flowerjill@aol.com",
   "status": "valid",
   "sub_status": ",
   "free_email": true,
   "did_you_mean": null,
   "account": "flowerjill",
   "domain": "aol.com",
   "domain_age_days": "8426",
   "smtp_provider": "yahoo",
   "mx_record": "mx-aol.mail.gm0.yahoodns.net",
   "mx_found": true,
   "firstname": "Jill",
   "lastname": "Stein",
   "gender": "female",
   "country": "United States",
   "region": "Florida",
   "city": "West Palm Beach",
   "zipcode": "33401",
   "processed_at": "2017-04-01 02:48:02.592"
}
Get the Java API Wrapper V2 from GitHub.

ZeroBounceApi zeroBounceApi = new ZeroBounceApi("YOUR_API_KEY",TIMEOUT_IN_SECONDS);

// validate email and assign result to a ZeroBounceResponse object
ZeroBounceResponse validation = zeroBounceApi.validate("flowerjill@aol.com", "99.110.204.1");
validation.getEmailAddress();
validation.getStatus();
validation.isDisposable();
validation.getCountry();
Response
{
   "address": "flowerjill@aol.com",
   "status": "valid",
   "sub_status": ",
   "free_email": true,
   "did_you_mean": null,
   "account": "flowerjill",
   "domain": "aol.com",
   "domain_age_days": "8426",
   "smtp_provider": "yahoo",
   "mx_record": "mx-aol.mail.gm0.yahoodns.net",
   "mx_found": true,
   "firstname": "Jill",
   "lastname": "Stein",
   "gender": "female",
   "country": "United States",
   "region": "Florida",
   "city": "West Palm Beach",
   "zipcode": "33401",
   "processed_at": "2017-04-01 02:48:02.592"
}

View our full developer Email Validation API Documentation

Try ZeroBounce API today!
TESTIMONIALS

Thousands of Happy Clients and Counting