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/[email protected]' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Javascript

const axios = require('axios');

axios.get('https://api.enrich.so/v1/api/[email protected]', {
    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': '[email protected]'}
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/[email protected]")
  .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/[email protected]")

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/[email protected]",
  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": "[email protected]",
        "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": "[email protected]",
        "reason": "Mail server records not found",
        "passed": false
    },
    "total_credits": 100000,
    "credits_used": 3149.3500000000013,
    "credits_remaining": 96850.65
}