Disposable Email Detection API
FreemiumDetect throwaway and temporary email addresses (Mailinator, 10MinuteMail and 8,900+ more domains) at sign-up — single, batch or classify.
Documentation
Detect throwaway and temporary email addresses (Mailinator, 10MinuteMail and 8,900+ more domains) at sign-up.
What you get
- Checks against a list of 8,900+ disposable domains, refreshed automatically
- Batch mode — up to 500 addresses in one call
- Classify an address as disposable, free webmail (Gmail, Yahoo…) or business/other
Great for sign-up forms, free-trial abuse prevention, lead quality scoring and CRM clean-up.
Quick start
Subscribe to a plan (the Basic plan is free), then call the API at https://disposable-email-detector.p.apihiver.com with your key in the X-API-Key header:
curl "https://disposable-email-detector.p.apihiver.com/v1/[email protected]" \
-H "X-API-Key: YOUR_API_KEY"Endpoints
| Method | Path | What it does |
|---|---|---|
GET | /v1/check | Is this email address or domain a disposable (throwaway) provider? |
POST | /v1/check/batch | Check up to 500 addresses or domains at once |
GET | /v1/stats | How many disposable domains are known |
GET | /v1/classify | Classify an address's domain: disposable, free webmail, or business |
Open the Endpoints tab to see every parameter, example request and example response, and to try the API live.
Errors
Every error is JSON with the same shape:
{"error": {"code": "INVALID_INPUT", "message": "email: Field required"}}| HTTP | Code | Meaning |
|---|---|---|
| 400 | INVALID_INPUT | A parameter is missing or has the wrong format — the message says which |
| 401 | UNAUTHORIZED | Missing or invalid X-API-Key |
| 429 | — | Plan quota or rate limit reached (see the X-RateLimit-* headers) |
| 502 / 503 / 504 | — | A data source or the API server is temporarily unavailable — retry after a few seconds |
Data & privacy
Data comes from the open disposable-email-domains list (CC0), plus our own list of free webmail providers.
Disposable Email Detection API FAQ
- Is the Disposable Email Detection API free?
- Yes. The Basic plan is free and includes 500 requests per month — no card needed. Paid plans start at ₹299 per month for 10,000 requests.
- How much does the Disposable Email Detection API cost?
- Basic: free for 500 requests; Pro: ₹299/month for 10,000 requests; Ultra: ₹999/month for 50,000 requests; Mega: ₹2,499/month for 2,00,000 requests. Billing is monthly and you can cancel any time.
- How do I use the Disposable Email Detection API?
- Subscribe to a plan on APIHiver, create an API key in the Console, then send requests to https://disposable-email-detector.p.apihiver.com with your key in the X-API-Key header. You can also try every endpoint in the browser playground first.
- What endpoints does the Disposable Email Detection API have?
- It has 4 endpoints: Is this email address or domain a disposable (throwaway) provider? (GET /v1/check); Check up to 500 addresses or domains at once (POST /v1/check/batch); How many disposable domains are known (GET /v1/stats); Classify an address's domain: disposable, free webmail, or business (GET /v1/classify).
- What are the Disposable Email Detection API rate limits?
- Basic: 2 requests per second; Pro: 5 requests per second; Ultra: 10 requests per second; Mega: 20 requests per second. Monthly quotas depend on the plan; every response includes X-RateLimit headers showing what's left.
- Can I use one API key for the Disposable Email Detection API and other APIs?
- Yes. One APIHiver key works for every API you subscribe to, so you don't need a separate account or key per provider.
Related APIs
Universities API
EducationBy APIHiver · Updated 1w ago
Search universities in 200+ countries, look up a university by web domain, and verify student email addresses.
Password Security API
SecurityBy APIHiver · Updated 1w ago
Password strength scoring, private breach checks against known leaked passwords, secure password generation, hashing and bcrypt checks.
Phone Number Validation API
SMSBy APIHiver · Updated 1w ago
Validate and format phone numbers for 240+ countries: valid or not, mobile or landline, carrier, region, and E.164 format.
Email Validation API
MessagingBy APIHiver · Updated 1w ago
Validate email addresses: syntax, domain and mail-server (MX) checks, disposable detection, typo suggestions and normalisation.
IFSC, GSTIN & UPI Validation API (India)
PaymentsBy APIHiver · Updated 1w ago
Validate Indian payment details — IFSC (with bank and branch), GSTIN, UPI ID format — plus IBAN and card BIN checks.
Endpoints
4 endpoints — full list is in the sidebar on larger screens.