Referência completa da API REST do Easy Email Verification.
https://api.easyemailverification.com/v1
All requests are made over HTTPS. Plain HTTP is not supported.
Passe sua chave de API como parâmetro de consulta em cada requisição. Mantenha-a em segredo — não a exponha no código do lado do cliente.
GET /v1/verify?apikey=YOUR_API_KEY&email=user@example.com
Verify a single email address. Returns a JSON object with all check results.
| Parameter | Type | Required | Description |
|---|---|---|---|
| apikey | string | required | Your API key from the dashboard. |
| string | required | The email address to verify (URL-encoded). |
curl "https://api.easyemailverification.com/v1/verify \
?apikey=YOUR_API_KEY \
&email=user%40example.com"
<?php
$apikey = 'YOUR_API_KEY';
$email = urlencode('user@example.com');
$url = "https://api.easyemailverification.com/v1/verify?apikey={$apikey}&email={$email}";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$body = curl_exec($ch);
curl_close($ch);
$data = json_decode($body, true);
if ($data['safe_to_send']) {
// safe to add to your list
}
import requests
API_KEY = "YOUR_API_KEY"
def verify_email(email: str) -> dict:
r = requests.get(
"https://api.easyemailverification.com/v1/verify",
params={"apikey": API_KEY, "email": email},
timeout=10
)
r.raise_for_status()
return r.json()
result = verify_email("user@example.com")
print(result["safe_to_send"]) # True / False
async function verifyEmail(email) {
const params = new URLSearchParams({
apikey: "YOUR_API_KEY",
email,
});
const res = await fetch(`https://api.easyemailverification.com/v1/verify?${params}`);
const data = await res.json();
return data;
}
const result = await verifyEmail("user@example.com");
console.log(result.safe_to_send); // true / false
{
"email": "user@example.com",
"user": "user",
"domain": "example.com",
"result": "valid",
"reason": "Accepted by mail server",
"mx_record": "mail.example.com",
"mx_domain": "example.com",
"accept_all": false,
"disposable": false,
"role": false,
"free": false,
"safe_to_send": true,
"did_you_mean": null
}
| Field | Type | Description |
|---|---|---|
| string | O endereço de e-mail normalizado que foi verificado. | |
| user | string | A parte local do e-mail (antes do @). |
| domain | string | A parte do domínio do e-mail (após o @). |
| result | string | valid, invalid ou unknown. |
| reason | string | Explicação legível do resultado. |
| mx_record | string | Hostname do registro MX de maior prioridade para o domínio. |
| mx_domain | string | Domínio do registro MX. |
| accept_all | boolean | true se o domínio aceita e-mail para qualquer endereço (catch-all). |
| disposable | boolean | true se o endereço é de um provedor descartável conhecido. |
| role | boolean | true se o endereço é baseado em função (info@, admin@, etc.). |
| free | boolean | true se o endereço usa um provedor de e-mail gratuito (Gmail, Yahoo, etc.). |
| safe_to_send | boolean | Sinal primário. true se o endereço passou em todas as verificações e é seguro para envio. |
| did_you_mean | string|null | Sugestão de correção para erros comuns de digitação (ex.: gnail.com → gmail.com). Nulo se não houver sugestão. |
Non-2xx responses include an error field with a machine-readable code and a human-readable message.
| HTTP | Error Code | Description |
|---|---|---|
| 400 | invalid_email | The email parameter is missing or malformed. |
| 401 | invalid_apikey | The apikey is missing, invalid, or revoked. |
| 402 | quota_exceeded | Daily verification quota exhausted. Upgrade your plan or wait for the reset. |
| 429 | rate_limited | Too many requests per second. Slow down or use the bulk endpoint. |
| 500 | server_error | Unexpected server error. Retry with exponential back-off. |
{
"error": "invalid_apikey",
"message": "The API key provided is invalid or has been revoked."
}
Planos gratuitos incluem 50 verificações por dia. Planos pagos escalam de 500 a 100.000 por dia. Entre em contato para volumes empresariais personalizados.
Official client libraries maintained by the Easy Email Verification team.
Cadastre-se grátis — 50 verificações/dia, sem cartão de crédito.
Obter Sua Chave de API Grátis →