Introduction
The Disposable Email API helps users to detect and block disposable emails from sign up. It checks if an email address is from a disposable email provider and returns the results in either JSON or XML format. Disposable email addresses (DEAs) are temporary email addresses that are only valid for a very short period of time. You can try out the online disposable email checker to learn more
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/v1/email/disposable
Request Parameters
Parameter | Type | Description |
---|---|---|
string | (required) The email address to check if is from a disposable email provider. | |
key | string | (required) API key. |
format | string |
(optional) Return the result in json (default) or xml format. Valid values: json | xml |
Response Parameters
Parameter | Type | Description |
---|---|---|
email_address | string | The input email address. |
is_disposable | string | Whether the email address is a temporary one from a disposable email provider. Return values: True, False |
credits_available | string | The number of credits left to call the API. |
error_code | string | The error code if there is any error. See error table below. |
error_message | string | The error message if there is any error. See error table below. |
Error Codes
error_code | error_message |
---|---|
100 | Missing parameter. |
101 | API key not found. |
102 | API key disabled. |
103 | API key expired. |
104 | Insufficient credits. |
105 | Unknown error. |
Disposable Email 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/v1/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/v1/email/disposable?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/v1/email/disposable?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/v1/email/disposable?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", "/v1/email/disposable?" + urllib.urlencode(p)) res = conn.getresponse() print res.read()