Disposable/Spam Email Check

Verify disposable or temporary email addresses instantly. Provide an email address, and our algorithm checks its validity against various sources to identify if it's disposable or temporary.

Curl

cURL 'https://api.enrich.so/v1/api/disposable-email-check?email=[e-mail]' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Javascript

const axios = require('axios');

axios.get('https://api.enrich.so/v1/api/disposable-email-check?email=[e-mail]', {
    headers: {accept: 'application/json', Authorization: 'Bearer <token>'}
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.log(error);
  });// Some code

Python

import requests
payload = {'email': '[e-mail]'}
headers = {'accept': 'application/json', 'authorization': 'Bearer <token>'}
resp = requests.get('https://api.enrich.so/v1/api/disposable-email-check', params=payload, headers=headers)
print (resp.text)

Java

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.enrich.so/v1/api/disposable-email-check?email=[e-mail]")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer <token>")
  .build();

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

Ruby

require 'uri'
require 'net/http'

url = URI("https://api.enrich.so/v1/api/disposable-email-check?email=[e-mail]")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = 'application/json'
request["authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Php

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enrich.so/v1/api/disposable-email-check?email=[e-mail]",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Example response

Status Code: 200 OK

{
    "success": true,
    "message": "Email record found.",
    "data": {
        "score": 100,
        "tests_passed": "3/3",
        "email": "[e-mail]",
        "passed": true,
        "mail_server_ip": "172.217.194.27",
        "mx_records": [
            {
                "host": "gmail-smtp-in.l.google.com.",
                "pref": 5
            },
            {
                "host": "alt1.gmail-smtp-in.l.google.com.",
                "pref": 10
            },
            {
                "host": "alt2.gmail-smtp-in.l.google.com.",
                "pref": 20
            },
            {
                "host": "alt3.gmail-smtp-in.l.google.com.",
                "pref": 30
            },
            {
                "host": "alt4.gmail-smtp-in.l.google.com.",
                "pref": 40
            }
        ],
        "metadata": {
            "title": "Gmail - Google",
            "description": "No information is available for this page. · Learn why",
            "url": "https://mail.google.com/mail/u/0/"
        }
    },
    "total_credits": 100000,
    "credits_used": 3148.3500000000013,
    "credits_remaining": 96851.65
}

Status code: 200 OK

{ // in case the email is temporary
    "success": true,
    "message": "Email record found.",
    "data": {
        "score": 0,
        "tests_passed": "0/3",
        "email": "[e-mail]",
        "reason": "Mail server records not found",
        "passed": false
    },
    "total_credits": 100000,
    "credits_used": 3149.3500000000013,
    "credits_remaining": 96850.65
}