Simple API Integration

One GET request. Works in any language. Add disposable detection to your sign-up flow in minutes.

cURL
JavaScript
Python
PHP
curl "https://api.minelead.io/v1/detect-disposable/?key=YOUR_API_KEY&email=user@tempmail.com"
const res = await fetch(
  'https://api.minelead.io/v1/detect-disposable/' +
  '?key=YOUR_API_KEY&email=user@tempmail.com'
);
const data = await res.json();

if (data.disposable_status === 'Disposable') {
  // block registration
  alert('Please use a real email address.');
}
import requests

resp = requests.get(
    'https://api.minelead.io/v1/detect-disposable/',
    params={'key': 'YOUR_API_KEY', 'email': 'user@tempmail.com'}
)
data = resp.json()

if data['disposable_status'] == 'Disposable':
    raise ValueError('Disposable email addresses are not allowed.')
$url = 'https://api.minelead.io/v1/detect-disposable/?'
     . http_build_query(['key' => 'YOUR_API_KEY', 'email' => 'user@tempmail.com']);
$data = json_decode(file_get_contents($url), true);

if ($data['disposable_status'] === 'Disposable') {
    http_response_code(422);
    die(json_encode(['error' => 'Disposable email not allowed']));
}

Example Response

{
  "status":             "success",
  "email":              "user@tempmail.com",
  "format_valid":       true,
  "domain_type":        "business",
  "disposability_score": 4.5,
  "spam_score":         "NA",
  "disposable_status":  "Disposable",
  "a_record_status":    "Missing",
  "ptr_record_status":  "Missing",
  "mx_record_status":   "Present",
  "timestamp":          1779989784.65681
}

Why SaaS Platforms Use Minelead

Built by a SaaS team, for SaaS teams — from real-world need to battle-tested API.

🚫

Block Fake Sign-Ups

Stop throwaway addresses at the registration gate before they waste your trial credits, skew analytics, or abuse free tiers.

Real-Time, Sub-Second Response

Every check resolves in milliseconds — seamlessly embedded in your sign-up form without adding any noticeable latency.

🗄️

Continuously Updated Database

Thousands of disposable providers are tracked and updated regularly, including new domains that emerge daily.

🏷️

Business vs. Personal Domain

Beyond disposable detection, the API also flags whether the email belongs to a business or personal domain — useful for B2B gating.

🔌

Any Stack, Any Language

A simple REST GET request that works with Python, Node.js, PHP, Ruby, Go — or directly from a cURL command. No SDKs required.

💳

Credit-Based Pricing

Pay only for what you use. Each detection consumes 1 credit. No subscription lock-in, no minimum commitment.

Common Use Cases

SaaS Free Trial Protection

Prevent users from spinning up unlimited free trials with throwaway addresses. Let real users in, block bots and abusers.

Email List Hygiene

Before importing a lead list or sending a campaign, scrub disposable addresses to protect your sender reputation and deliverability.

Referral & Reward Programs

Stop self-referral fraud where users create multiple accounts with throwaway emails to collect referral bonuses repeatedly.

B2B Lead Qualification

Filter out personal and disposable addresses from inbound leads automatically — only route genuine business emails to your sales team.

Start Blocking Fake Sign-Ups Today

Get 25 free detections every month. No credit card required. Add the API to your sign-up flow in under 5 minutes.

Get Free API Key API Documentation

Frequently Asked Questions

What is a disposable email address?
A disposable (or temporary) email address is one created with the intention of being used briefly and then discarded. Services like Mailinator, 10MinuteMail, Guerrilla Mail, and thousands of others provide these addresses. They're commonly used to bypass sign-up requirements, exploit free trials, and avoid spam — but they create serious problems for SaaS businesses.
How accurate is the detection?
Minelead maintains a regularly updated database of known disposable email providers. New domains are added continuously. The detection is highly accurate for the most common providers and covers the long tail of less-known throwaway services. For very new or obscure providers, the API returns 'Unknown' rather than making a false classification.
What does 'domain_type' mean in the response?
The domain_type field tells you whether the email uses a personal (webmail) provider like Gmail, Hotmail, or Yahoo, versus a business domain. For B2B SaaS, you can use this to enforce business-email-only sign-ups — blocking both disposable addresses and personal webmail providers.
How many credits does each check cost?
Each detection request costs 1 credit. Free accounts receive 25 credits per month at no cost. Paid plans provide larger credit pools for higher volume usage.
Can I check emails in bulk?
The API processes one email per request. For bulk checking, call the endpoint in parallel or in a loop — it's stateless and highly concurrent. If you need a bulk file upload workflow, the Minelead email verifier supports batch processing.
Searching ...
×
Set a Password
You have created your account using Google SSO. You need to set a password.

Phone Verification