EMAIL

Verificação de email

Checa sintaxe, registros MX e, opcionalmente, faz uma sondagem SMTP — pra saber se um email tem chance real de existir antes de mandar algo pra ele.

Email verification

Checks syntax, MX records and, optionally, runs an SMTP probe — to know whether an email actually has a chance of existing before you send anything to it.

SYNC resposta na mesma chamada answers in the same call

Endpoint

GET /api/v1/email/verify verifica um endereço de email verifies an email address

Parâmetros

Parameters

Nome	Name	Onde	In	Descrição	Description
`email`	query	obrigatório — o endereço a verificar	required — the address to check

Exemplo

Example

curl "https://email.alicercelabs.com.br/api/v1/email/verify?email=voce@exemplo.com" \
  -H "Authorization: Bearer <token>"

{
  "success": true,
  "data": {
    "email": "voce@exemplo.com",
    "reachable": "unknown",
    "syntax_valid": true,
    "has_mx": true,
    "disposable": false,
    "role_account": false,
    "free": false
  },
  "meta": { "elapsed_ms": 6, "request_id": "..." }
}

reachable só vira "yes"/"no" quando a checagem SMTP está ligada nesse ambiente (EMAIL_SMTP_CHECK=true); do contrário fica "unknown" e a resposta se baseia só em sintaxe + MX.

reachable only becomes "yes"/"no" when SMTP checking is enabled on this environment (EMAIL_SMTP_CHECK=true); otherwise it stays "unknown" and the response is based on syntax + MX alone.

Erros possíveis

Possible errors

Status	Motivo	Reason
400	parâmetro `email` ausente ou com formato inválido	missing or malformed `email` parameter
401	token ausente ou inválido	missing or invalid token
429	limite de taxa excedido (da API), ou muitas checagens SMTP pro mesmo domínio	API rate limit exceeded, or too many SMTP probes against the same domain
502	erro ao verificar (falha na sondagem SMTP)	verification failed (SMTP probe error)
503	verificador não disponível nesse ambiente	verifier not available on this environment

Limites

Limits

10.000/dia · 416/hora, por IP chamador. Quando a sondagem SMTP está ligada, existe um limite adicional, por domínio de destino, pra não ser confundido com abuso pelos servidores de email de terceiros.

10,000/day · 416/hour, per calling IP. When SMTP probing is on, there's an additional per-destination-domain limit, so we don't get flagged as abuse by third-party mail servers.