Referência da API

Referência completa da API REST do Easy Email Verification.


URL Base

https://api.easyemailverification.com/v1

All requests are made over HTTPS. Plain HTTP is not supported.


Autenticação

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.

Example
GET /v1/verify?apikey=YOUR_API_KEY&email=user@example.com

GET

/v1/verify

Verify a single email address. Returns a JSON object with all check results.

Query Parameters
ParameterTypeRequiredDescription
apikey string required Your API key from the dashboard.
email string required The email address to verify (URL-encoded).
Code Examples
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
Example Response 200 OK
{
  "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
}

Response Schema

FieldTypeDescription
email 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.

Códigos de Erro

Non-2xx responses include an error field with a machine-readable code and a human-readable message.

HTTPError CodeDescription
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.
401 Unauthorized
{
  "error":   "invalid_apikey",
  "message": "The API key provided is invalid or has been revoked."
}

Limites de Requisição

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.

Free
50 / day
No credit card
Starter
500 / day
From $9/mo
Growth
5,000 / day
From $29/mo
Pro
100,000 / day
From $99/mo
Enterprise
Custom
Contact us

View full pricing →


SDKs Oficiais

Official client libraries maintained by the Easy Email Verification team.

Pronto para integrar?

Cadastre-se grátis — 50 verificações/dia, sem cartão de crédito.

Obter Sua Chave de API Grátis →