Deprecated

Email API Overview

Do you run a service in which you would like to reduce the number of anonymous subscribers helping to reduce userbase contamination? This API allows you to identify disposable email addresses or one time use email addresses so that you can take action at the time of user signup. The API detects known domains associated with disposable email addresses, and in addition detects sub addressing for domains where the behavior is known.

Detect Disposable Email Addresses

Use the disposable method for identifying email addresses that either use sub addressing or are associated with known one time use or disposable email addresses. NOTE: Please take efforts to not expose your private api key in client side applications of this API.

JSON

curl -H"X-FullContact-APIKey:$your_key" 'https://api.fullcontact.com/v2/email/disposable.json?email=joe+tag@sharklasers.com'

XML

curl -H"X-FullContact-APIKey:$your_key" 'https://api.fullcontact.com/v2/email/disposable.xml?email=joe+tag@sharklasers.com'

Parameters

apiKey

This API key is assigned to you by FullContact. It is used to identify and authorize your request. Your API key should be kept private, and should never be displayed publicly.

email

The email address that should be queried for being a disposable email address.

Note: The value for email must be URL encoded.

Example Responses

The API responds with JSON or XML.

JSON

{
     "status": 200,
     "usernameSubAddressing": "unknown",
     "disposableEmailDomain": "true",
     "message": "Email username contains sub address characters but is unknown. Email's domain is likely associated with disposable email addresses."
}

XML

<?xml version="1.0" encoding="UTF-8" ?>
<response>
   <status>200</status>
   <usernameSubAddressing>unknown</usernameSubAddressing>
   <disposableEmailDomain>true</disposableEmailDomain>
   <message>
    Email username contains sub address characters but is unknown. Email's domain is likely associated with disposable email addresses.
   </message>
</response>

Response Schema

The following is a description of the Disposable Email API response schema. It includes every possible field, collection, and value you can expect to receive. Note that certain fields and collections may only appear in the response when the data is available.

JSON

{
     "status": {"type":"number"},  // common status codes can be found below
     "usernameSubAddressing": {"type":"string"},  // true, false, or unknown
     "disposableEmailDomain": {"type":"string"},  // true, false, or retry
     "message": {"type":"string"}
}

usernameSubAddressing

Possible values are:

  • true - the username is sub-addressed (the domain behavior for sub-addressing is understood),
  • false - the username does not contain commonly used characters in sub-addressing,
  • unknown - the username does contain commonly used characters in sub-addressing but the domain behavior is not understood.

disposableEmailDomain

Possible values are:

  • true - the domain is believed to be associated with disposable email,
  • false - the domain is not believed to be associated with disposable email,
  • unknown - the domain is not believed to be a valid email-accepting domain.
  • retry - the behavior of the domain has not been analyzed. This will only be returned when the response code is a 202.

Disposable Email API Diagram

Email Flow Diagram