Email Verification API

Verify email addresses in real time — detect disposable emails, check MX records, and block fake signups directly from your app.

Quickstart Code Samples

One POST request returns a full trust verdict — category, MX record, domain age, disposable flag, and more. The API key goes in the Authorization header.

import requests

API_KEY = "your_api_key"
EMAIL   = "[email protected]"

response = requests.post(
    "https://api.user.cleaning/v1/external-api-requests/check-email",
    params={"email": EMAIL},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
result = response.json()
print(result["category"])  # "black" | "grey" | "white"

const API_KEY = "your_api_key";
const EMAIL   = "[email protected]";

const res = await fetch(
  `https://api.user.cleaning/v1/external-api-requests/check-email?email=${encodeURIComponent(EMAIL)}`,
  {
    method: "POST",
    headers: { Authorization: `Bearer ${API_KEY}` },
  }
);
const result = await res.json();
console.log(result.category); // "black" | "grey" | "white"

<?php
$apiKey = "your_api_key";
$email  = "[email protected]";

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => "https://api.user.cleaning/v1/external-api-requests/check-email?email=" . urlencode($email),
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["Authorization: Bearer $apiKey"],
]);
$result = json_decode(curl_exec($ch), true);
echo $result["category"]; // "black" | "grey" | "white"

require "net/http"
require "json"
require "uri"

api_key = "your_api_key"
email   = "[email protected]"

uri = URI("https://api.user.cleaning/v1/external-api-requests/check-email")
uri.query = URI.encode_www_form(email: email)

req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{api_key}"

res  = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |h| h.request(req) }
data = JSON.parse(res.body)
puts data["category"] # "black" | "grey" | "white"

Response fields: email, domain, category, type, mx_record, domain_age, premium, date_added. See the full API reference for error codes, rate limits, and advanced options.

Key Management

Create your email validation API key to get key-level insights. Create separate keys for development and production environments. Track your usage statistics per key in real time, getting a clear view of request volume and email verification outcomes. Manage your API keys from a user-friendly interface. Struggling with integration? Check our docs page to see full usage examples and code snippets.

Email Category Management

Every request through the verify email API is validated against a proprietary database with disposable domains and gets validated with 99.5% accuracy. Manage your personal email blocklist in our platform. Our disposable email checker and temporary email detector track addresses from throwaway providers, masked domains, and addresses without a working website. We're the only platform providing protection from premium email domains.

Customise the classification logic by dragging categories between lists. Changes take effect immediately on all subsequent API calls — no redeployment required.

API Usage Analytics

Track your email requests with daily, weekly or monthly resolution — correlate spikes in invalid addresses with specific campaigns, data sources or attacks.