SINGLE EMAIL

Validate and verify single email address. Check if email address is disposable, temporary, has invalid MX records, detect if its mistyped, inactive or non-existent. If you believe some email address is disposable and we haven't detected it - feel free to submit it here.


API Usage Full Documentation

Single email address


Request

Requires just email parameter and email address after slash.

                        GET https://www.disify.com/api/email/your@example.com
                    

Response

Results will be displayed in JSON string.

                        
{
    "format": true,
    "domain": "example.com",
    "disposable": false,
    "dns": true
}
                        
                    

Mass emails & domains


Request

Insert all emails as single string right after email parameter (after slash). Each email/domain will be automatically recognized by comma, space or new line.
Then simply attach parameter mass (or bulk alias) after email list slash.
If you want to mass check domains, simply replace parameter email with domain inside URL.

                        GET https://www.disify.com/api/email/your@example.com,another@mail.com/mass
                    

Response

You will get JSON string with statistics of your email validations and new session value that can be used to view and download your valid emails.

                        
{
    "total": 2,
    "invalid_format": 0,
    "invalid_dns": 0,
    "disposable": 0,
    "unique": 2,
    "valid": 1,
    "session": "d117271ce938bf91bc718f6cfb7954de"
}
                        
                    

View valid results


Request

Use previously returned session value (from mass email/domain check) after URL parameter view.

Optional parameters after session value:
download will trigger force download.
separate (or comma, separator aliases) will display emails in single string separated by comma instead of new-line.

                        GET https://www.disify.com/api/view/d117271ce938bf91bc718f6cfb7954de
                    

Response

You will get string with valid email addresses separated by new lines. Use parameter separator (or separate, mass aliases) to separate emails by comma.

Important! Session variables are bound to your current session and each next mass email/domain request with same session variable will overwrite previously generated list. Validated lists are destroyed and no longer available after short period of time (usually 1 hour).

Examples

Here are some examples you might find useful. All requests can be done both using GET or POST methods.

                                
    $curl = curl_init();

    $data = [
        'email' => 'your@example.com',
    ];

    $post_data = http_build_query($data);

    curl_setopt_array($curl, array(
        CURLOPT_URL => "https://www.disify.com/api/email",
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => "POST",
        CURLOPT_POSTFIELDS => $post_data,
    ));

    $response = curl_exec($curl);
    $err = curl_error($curl);

    curl_close($curl);

    if ($err) {
        echo "cURL Error #:" . $err;
    } else {
        echo $response;
    }
                                
                            
                                
    var client = new RestClient("https://www.disify.com/api/email");
    var request = new RestRequest(Method.POST);
    request.AddParameter("email", "your@example.com");
    IRestResponse response = client.Execute(request);
                                
                            
                                
    OkHttpClient client = new OkHttpClient();

    MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
    RequestBody body = RequestBody.create(mediaType, "email=your@example.com");
    Request request = new Request.Builder()
      .url("https://www.disify.com/api/email")
      .post(body)
      .build();

    Response response = client.newCall(request).execute();
                                
                            

Disposable

Disposable email address (DEA) is a temporary, throw-away address that expires after a short period of time. DEA provider websites offer a service where users can generate a temporary email address (with about a 10 minute lifespan, for example). Some of the most common DEA providers are 10 Minute Mail, Temp-Mail, and Fake Inbox.

DNS

Email address can be still disposable or non-existant, that's why not only we do internal database check, but also additional validation against email address DNS records. We check if domain has valid MX records and if its connected to one of disposable email providers.

SMTP

There are also cases where email address providers are legit and well known, but mailbox account itself could be non-existent. In this case we must do real SMTP request directly to email address and see if we get successful response. This feature is currently under development.

We have up-to-date database with more than 30,000+ disposable email addresses and providers.

If you believe some email address is disposable and we haven't detected it - feel free to submit it here