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.
Descripción general
Casos de uso
- Prevent spam and fraudulent signups
- Improve email deliverability rates
- Maintain clean user databases
- Enhance data quality for marketing campaigns
Funcionalidades
Puntos finales de la API
Check Single Email
Validate whether an email address uses a disposable domain
https://requiems.xyz/v1/networking/disposable/check
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
string |
Obligatorio | The email address to check |
Pruébalo
Demostración en vivoSolicitud
The email address to check
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
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 |
Ejemplos de código
curl -X POST https://requiems.xyz/v1/networking/disposable/check \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'
import requests
url = "https://requiems.xyz/v1/networking/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://requiems.xyz/v1/networking/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://requiems.xyz/v1/networking/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)
Respuestas de error
Invalid request body
The request body is missing or malformed
Invalid email format
The email address format is invalid
Check Batch Emails
Validate multiple email addresses in a single request (max 100 emails)
https://requiems.xyz/v1/networking/disposable/batch
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| emails | array<string> |
Obligatorio | Array of email addresses to check (max 100) |
Pruébalo
Demostración en vivoSolicitud
Array of email addresses to check (max 100)
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| results | array<object> |
Array of check results for each email |
| total | integer |
Total number of emails checked |
Ejemplos de código
curl -X POST https://requiems.xyz/v1/networking/disposable/batch \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"emails": ["[email protected]", "[email protected]"]
}'
import requests
url = "https://requiems.xyz/v1/networking/disposable/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://requiems.xyz/v1/networking/disposable/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);
Respuestas de error
Invalid request body
The request body is missing or malformed
emails array is required
The emails field is missing
Maximum 100 emails allowed per request
Too many emails in the request
Check Domain
Check if a specific domain is in the disposable blocklist
https://requiems.xyz/v1/networking/disposable/domain/{domain}
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| domain | string |
Obligatorio | The domain to check |
Pruébalo
Demostración en vivoSolicitud
The domain to check
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| domain | string |
The domain that was checked |
| is_disposable | boolean |
Whether the domain is in the disposable blocklist |
Ejemplos de código
curl https://requiems.xyz/v1/networking/disposable/domain/tempmail.com \
-H "requiems-api-key: YOUR_API_KEY"
import requests
domain = "tempmail.com"
url = f"https://requiems.xyz/v1/networking/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://requiems.xyz/v1/networking/disposable/domain/${domain}`,
{
headers: {
'requiems-api-key': 'YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);
Respuestas de error
domain parameter is required
The domain parameter is missing
Get Statistics
Get statistics about the disposable email blocklist
https://requiems.xyz/v1/networking/disposable/stats
Pruébalo
Demostración en vivoSolicitud
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| total_domains | integer |
Total number of disposable domains in the blocklist |
Ejemplos de código
curl https://requiems.xyz/v1/networking/disposable/stats \
-H "requiems-api-key: YOUR_API_KEY"
List Domains (Paginated)
Get a paginated list of all disposable domains in the blocklist
https://requiems.xyz/v1/networking/disposable/domains
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| page | integer |
Opcional | Page number (default: 1) |
| per_page | integer |
Opcional | Items per page (default: 100, max: 1000) |
Pruébalo
Demostración en vivoSolicitud
Page number (default: 1)
Items per page (default: 100, max: 1000)
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| domains | array<string> |
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 |
Ejemplos de código
curl "https://requiems.xyz/v1/networking/disposable/domains?page=1&per_page=100" \
-H "requiems-api-key: YOUR_API_KEY"