Disposable Email Checker
Detect disposable and temporary email addresses to prevent fraud and improve data quality. Our comprehensive blocklist is continuously updated to catch the latest disposable email providers.
Overview
Use Cases
- Prevent spam and fraudulent signups
- Improve email deliverability rates
- Maintain clean user databases
- Enhance data quality for marketing campaigns
Features
90,000+ disposable domains in blocklist
Real-time email validation
Batch processing (up to 100 emails)
Domain-level checking
High-performance lookups
API Endpoints
Check Single Email
Validate whether an email address uses a disposable domain
POST
https://api.requiems.xyz/v1/email/disposable/check
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
string |
Required | The email address to check |
Try it out
Live DemoRequest
The email address to check
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
string |
The email address that was checked | |
| is_disposable | boolean |
Whether the email uses a disposable domain |
| domain | string |
The domain part of the email address |
Code Examples
curl -X POST https://api.requiems.xyz/v1/email/disposable/check \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'import requests
url = "https://api.requiems.xyz/v1/email/disposable/check"
headers = {
"requiems-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
}
data = {"email": "[email protected]"}
response = requests.post(url, headers=headers, json=data)
print(response.json())const response = await fetch('https://api.requiems.xyz/v1/email/disposable/check', {
method: 'POST',
headers: {
'requiems-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ email: '[email protected]' })
});
const data = await response.json();
console.log(data);require 'net/http'
require 'json'
uri = URI('https://api.requiems.xyz/v1/email/disposable/check')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = { email: '[email protected]' }.to_json
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.parse(response.body)Error Responses
400
Invalid request body
The request body is missing or malformed
400
Invalid email format
The email address format is invalid
Check Batch Emails
Validate multiple email addresses in a single request (max 100 emails)
POST
https://api.requiems.xyz/v1/email/disposable/check-batch
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| emails | array |
Required | Array of email addresses to check (max 100) |
Try it out
Live DemoRequest
Enter JSON array, e.g., ["[email protected]", "[email protected]"]
Array of email addresses to check (max 100)
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| results | array |
Array of check results for each email |
| total | integer |
Total number of emails checked |
Code Examples
curl -X POST https://api.requiems.xyz/v1/email/disposable/check-batch \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"emails": ["[email protected]", "[email protected]"]
}'import requests
url = "https://api.requiems.xyz/v1/email/disposable/check-batch"
headers = {
"requiems-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
}
data = {
"emails": ["[email protected]", "[email protected]"]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())const response = await fetch('https://api.requiems.xyz/v1/email/disposable/check-batch', {
method: 'POST',
headers: {
'requiems-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
emails: ['[email protected]', '[email protected]']
})
});
const data = await response.json();
console.log(data);Error Responses
400
Invalid request body
The request body is missing or malformed
400
emails array is required
The emails field is missing
400
Maximum 100 emails allowed per request
Too many emails in the request
Check Domain
Check if a specific domain is in the disposable blocklist
GET
https://api.requiems.xyz/v1/email/disposable/domain/{domain}
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| domain | string |
Required | The domain to check |
Try it out
Live DemoRequest
The domain to check
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| domain | string |
The domain that was checked |
| is_disposable | boolean |
Whether the domain is in the disposable blocklist |
Code Examples
curl https://api.requiems.xyz/v1/email/disposable/domain/tempmail.com \
-H "requiems-api-key: YOUR_API_KEY"import requests
domain = "tempmail.com"
url = f"https://api.requiems.xyz/v1/email/disposable/domain/{domain}"
headers = {"requiems-api-key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())const domain = 'tempmail.com';
const response = await fetch(
`https://api.requiems.xyz/v1/email/disposable/domain/${domain}`,
{
headers: {
'requiems-api-key': 'YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);Error Responses
400
domain parameter is required
The domain parameter is missing
Get Statistics
Get statistics about the disposable email blocklist
GET
https://api.requiems.xyz/v1/email/disposable/stats
Try it out
Live DemoRequest
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| total_domains | integer |
Total number of disposable domains in the blocklist |
Code Examples
curl https://api.requiems.xyz/v1/email/disposable/stats \
-H "requiems-api-key: YOUR_API_KEY"List Domains (Paginated)
Get a paginated list of all disposable domains in the blocklist
GET
https://api.requiems.xyz/v1/email/disposable/domains
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| page | integer |
Optional | Page number (default: 1) |
| per_page | integer |
Optional | Items per page (default: 100, max: 1000) |
Try it out
Live DemoRequest
Page number (default: 1)
Items per page (default: 100, max: 1000)
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| domains | array |
Array of domain names |
| total | integer |
Total number of domains in blocklist |
| page | integer |
Current page number |
| per_page | integer |
Number of items per page |
| has_more | boolean |
Whether there are more pages available |
Code Examples
curl "https://api.requiems.xyz/v1/email/disposable/domains?page=1&per_page=100" \
-H "requiems-api-key: YOUR_API_KEY"Frequently Asked Questions
The blocklist is updated weekly with new disposable email providers. Updates are automatically reflected in the API with no action required on your end.
Yes! Please email [email protected] with domains you'd like to suggest. We review all submissions.
No, this API only checks if the domain is disposable. For full email validation (syntax, DNS, mailbox verification), consider our Email Validation API (coming soon).
Disposable emails are temporary email addresses that users can create without registration, typically used to bypass signup forms or avoid spam. Examples include services like tempmail.com, guerrillamail.com, and 10minutemail.com.