Motivos de verificação
Referência completa dos códigos reason retornados pela API do BillionVerify: o que cada motivo significa e como agir diante dele.
Veja como funciona
Como funciona a verificação de e-mail? Camada por camada
Como funciona a verificação de e-mail, da sintaxe ao SMTP: siga um endereço pelas nove camadas que decidem o resultado. Veja onde os endereços param antes, como a resposta do servidor de e-mail é lida, como o catch-all é testado e quanto cada resultado custa.
Todo resultado de verificação inclui um campo reason que explica por que o email recebeu o status que recebeu. Use esta referência para montar uma lógica de filtragem precisa, diagnosticar resultados inesperados e ajustar a sua estratégia de envio.
Como os motivos funcionam
O campo reason aparece em todas as respostas de verificação, ao lado do campo status:
{
"email": "user@example.com",
"status": "valid",
"reason": "smtp_deliverable"
}Os motivos são identificadores de texto estáveis: você pode usá-los diretamente em regras de filtragem ou em condições do seu fluxo posterior.
Como cada tipo de caixa postal é verificado
O motivo que você recebe depende de como o provedor do destinatário pode ser verificado:
- Domínios corporativos (Google Workspace, Microsoft 365, servidores de email próprios) recebem uma verificação SMTP RCPT ao vivo na caixa postal exata. Um endereço aleatório do mesmo domínio é testado primeiro, então domínios catch-all, o relay interno do Microsoft 365 e gateways de segurança em modo accept-all são reportados como
catchall, e não comovalid. - Gmail recebe uma verificação SMTP RCPT ao vivo.
- Yahoo, AOL, Outlook.com, Hotmail, Live e MSN bloqueiam a verificação SMTP, por isso são checados por consultas de conta específicas de cada provedor. Elas retornam motivos
yahoo_api_*oumicrosoft_api_*e confirmam se a conta existe. - GMX, web.de, Mail.ru, Yandex e outros provedores regionais são verificados com um ritmo próprio de cada provedor. Limites de taxa, greylisting e verificações recusadas levam a mais resultados
unknown. - Apple iCloud, Proton e Tuta não permitem nenhuma verificação confiável, então os endereços deles sempre retornam
unknowncomsmtp_unverifiable.
Resultados unknown nunca são cobrados, seja qual for o motivo.
Válido
Emails com status: "valid" têm a entrega confirmada.
| Motivo | Descrição |
|---|---|
smtp_deliverable | O SMTP RCPT retornou 250 OK: caixa postal com entrega confirmada. Também é gerado quando o modo DBEB do Microsoft 365 confirma a entrega. |
yahoo_api_verified | A consulta de conta do Yahoo ou da AOL confirmou que a conta existe. |
microsoft_api_verified | A consulta de conta pessoal da Microsoft (Outlook.com, Hotmail, Live, MSN) confirmou que a conta existe. |
unitedinternet_api_verified | A consulta de conta do GMX.com / mail.com confirmou que a conta existe. |
Inválido
Emails com status: "invalid" devem ser removidos da sua lista, pois a entrega não é possível.
| Motivo | Descrição |
|---|---|
invalid_syntax | O endereço de email falha na análise de sintaxe: parte local ou domínio malformado, ou @ ausente. Nunca é cobrado. |
no_mx_records | O domínio não tem registros MX (NXDOMAIN ou consulta MX com resultado vazio). |
null_mx | O domínio publica um registro null MX (RFC 7505): ele declara explicitamente que não aceita mensagens. |
spf_reject_all | O domínio não tem registros MX e tem um registro SPF com -all: o domínio rejeita explicitamente todas as mensagens recebidas. |
mailbox_not_found | O SMTP 550/5xx confirmou que a caixa postal não existe no servidor remoto. |
mailbox_disabled | A caixa postal existe, mas foi desativada. |
host_not_found | O hostname do MX não respondeu: host inacessível ou inexistente. |
yahoo_api_not_deliverable | A consulta de conta do Yahoo ou da AOL confirmou que a conta não existe. |
microsoft_api_not_deliverable | A consulta de conta pessoal da Microsoft confirmou que a conta não existe. |
unitedinternet_api_not_deliverable | A consulta de conta do GMX.com / mail.com confirmou que a conta não existe. |
Desconhecido
Emails com status: "unknown" não puderam ser verificados de forma conclusiva. Resultados desconhecidos nunca são cobrados. Alguns são temporários (permitem nova tentativa); outros representam limitações estruturais.
| Motivo | Nova tentativa | Descrição |
|---|---|---|
smtp_unverifiable | Não | O provedor não permite nenhuma verificação SMTP confiável (Apple iCloud, Proton, Tuta). |
smtp_blocked | Não | O servidor SMTP remoto bloqueou explicitamente a conexão ou a colocou em lista de bloqueio. |
smtp_eof_blocked | Sim | O MX fechou a conexão antes de enviar o banner, em geral por um limitador de taxa por IP ou uma regra do fail2ban. |
smtp_timeout | Sim | A operação SMTP expirou (prazo do contexto ou cancelamento). |
smtp_connection_failed | Sim | Falha genérica de conexão SMTP: nenhuma classe mais específica correspondeu. |
smtp_rate_limited | Sim | O servidor SMTP remoto retornou uma resposta de limite de taxa (421, 450, 451 ou limite de mensagens excedido). |
smtp_greylisted | Sim | Resposta genérica de greylisting detectada: tente de novo após um intervalo. |
smtp_550_unclassified | Sim | O servidor retornou um 550 que não significa claramente "usuário desconhecido", por isso não é tratado como inválido. |
smtp_egress_unavailable | Sim | Nenhuma saída de verificação estava disponível para este provedor no momento da checagem. |
smtp_egress_unselectable | Não | Nenhuma saída de verificação tem permissão para alcançar este provedor. |
mimecast_greylist | Sim | Greylist / falha temporária 451 específica da Mimecast. |
proofpoint_ad_lookup | Sim | Consulta assíncrona ao AD da Proofpoint em andamento (falha temporária 421 4.1.1 durante a validação do destinatário). |
proofpoint_egress_listed | Não | Domínio protegido pela Proofpoint em que as nossas verificações não estão sendo respondidas no momento. |
policy_temp_fail | Sim | Falha temporária 4xx genérica da aplicação de política remota. |
google_rate_limit | Sim | O MX do Google retornou uma resposta de limite de taxa ou de rejeição temporária. |
google_dmarc_misalignment | Não | A configuração DMARC do domínio está desalinhada: o Google rejeita com base na política DMARC. |
m365_ip_rep_block | Sim | O Microsoft 365 rejeitou a conexão por causa da reputação do IP (códigos 4.7.650 / 4.7.651). |
tonline_egress_not_whitelisted | Não | A T-Online só aceita verificações de remetentes em lista de permissão, então a caixa postal não pode ser verificada. |
mailbox_full | Não | A caixa postal existe, mas excedeu a cota (SMTP 452 ou resposta de caixa de entrada cheia). |
dns_timeout | Sim | A consulta de DNS ou de MX expirou: problema transitório do resolvedor. |
dns_lookup_error | Sim | A consulta de DNS falhou com um erro diferente de NXDOMAIN (SERVFAIL, timeout de UDP ou erro do resolvedor). |
dns_resolution_failed | Sim | A resolução de DNS falhou por um motivo transitório. |
yahoo_api_error | Sim | A consulta de conta do Yahoo / AOL falhou: erro geral. |
yahoo_api_unavailable | Sim | A consulta de conta do Yahoo / AOL estava indisponível (falha de saúde em nível de lote). |
yahoo_api_eof | Sim | A consulta de conta do Yahoo / AOL retornou EOF antecipado: queda transitória de TCP/TLS. |
yahoo_api_rate_limited | Sim | A consulta de conta do Yahoo / AOL sofreu limite de taxa. |
microsoft_api_error | Sim | A consulta de conta pessoal da Microsoft falhou ou foi limitada. |
microsoft_api_unavailable | Sim | A consulta de conta pessoal da Microsoft estava indisponível. |
unitedinternet_api_error | Sim | A consulta de conta do GMX.com / mail.com falhou. |
unitedinternet_api_unavailable | Não | A consulta de conta do GMX.com / mail.com estava indisponível nesta execução. |
capacity_deferred | Sim | A capacidade de verificação do provedor estava cheia, então a checagem foi adiada. |
provider_capacity_exhausted | Não | A capacidade do provedor ficou cheia durante toda a janela de novas tentativas (cerca de duas horas), então o trabalho terminou sem conclusão para esses endereços. |
carrier_blocked | Não | Domínio de operadora japonesa (docomo.ne.jp, au.com etc.): o SMTP é bloqueado pela política da operadora. |
internal_verifier_error | Sim | Erro interno do verificador não classificado: falha transitória. |
rate_limited | Sim | O email sofreu limite de taxa durante o processamento em lote (alias de smtp_rate_limited em trabalhos com arquivo). |
bucket_default_skip_smtp_unknown | Não | O modo de verificação da conta está configurado para pular o SMTP: o resultado se baseia apenas nas checagens de domínio. |
mx_only_verification_semaphore_timeout | Sim | O semáforo de concorrência SMTP expirou: o fallback somente MX confirmou registros MX válidos, mas a caixa postal não pôde ser verificada individualmente. |
Catch-all
Emails com status: "catchall" pertencem a domínios que aceitam mensagens para qualquer endereço. A entrega individual não pode ser confirmada.
| Motivo | Descrição |
|---|---|
catch_all_domain | Domínio confirmado como catch-all: a sonda RCPT aleatória foi aceita pelo servidor de email. |
catch_all_deliverable | Domínio catch-all, e o endereço específico também retornou 250 OK no RCPT. |
catch_all_inferred | Status catch-all inferido a partir de evidências em cache (indireto, não é uma sonda ao vivo). |
m365_internal_relay | Domínio do Microsoft 365 configurado como relay interno: todos os RCPT foram aceitos, mas não verificados individualmente. |
gateway_accept_all | O gateway de segurança (Mimecast, Proofpoint etc.) está em modo accept-all. |
forwarding_alias | Serviço de alias de encaminhamento de email (SimpleLogin, Firefox Relay, Duck.com). |
yahoo_isp_accept_all | Domínio de provedor de internet hospedado na infraestrutura de email do Yahoo (por exemplo att.net, sbcglobal.net, verizon.net): o provedor aceita todos os destinatários, então não é possível verificar no nível da caixa postal. |
region_consumer_accept_all | Domínio regional de consumidor conhecido por aceitar todas as mensagens recebidas (resultados mais antigos). |
bucket_default_skip_smtp_catchall | O modo de verificação da conta está configurado para pular a detecção catch-all por SMTP. |
Role
Emails com status: "role" pertencem a caixas compartilhadas (por exemplo info@, support@, noreply@). Esses endereços costumam ter entrega possível, mas pouco engajamento.
Os endereços de role herdam o reason da verificação SMTP subjacente: não existem códigos de motivo dedicados a este status. Por exemplo, um endereço de role que passa no SMTP mostrará reason: "smtp_deliverable".
Descartável
Emails com status: "disposable" pertencem a serviços de email temporário. Aceitá-los costuma resultar em cadastros de baixa qualidade.
| Motivo | Descrição |
|---|---|
disposable_domain | O domínio consta como um provedor de email descartável / temporário conhecido. |
Arriscado (somente resultados antigos)
As novas verificações não retornam mais status: "risky". A única origem dele, a checagem da Spamhaus Domain Blocklist, foi removida em 2026-09-11. Você ainda pode ver risky em resultados criados antes dessa data.
Nesses resultados antigos, risky significava que o endereço provavelmente tinha entrega possível, mas o domínio do destinatário constava na Spamhaus por atividade de spam, phishing, malware ou C&C de botnet. O array risk_reasons explica o motivo:
Valor de risk_reasons | Descrição |
|---|---|
spamhaus_dbl_spam | O domínio consta como fonte de spam. |
spamhaus_dbl_phish | O domínio consta como domínio de phishing. |
spamhaus_dbl_malware | O domínio consta como domínio de distribuição de malware. |
spamhaus_dbl_botnet_cc | O domínio consta como infraestrutura de comando e controle de botnet. |
Usando motivos na filtragem
Você pode combinar status e reason para segmentar listas com precisão. Por exemplo, para manter os emails unknown que são desconhecidos apenas por problemas temporários:
function isRetryableUnknown(result) {
const retryableReasons = new Set([
'capacity_deferred', 'context_cancelled', 'dns_lookup_error',
'dns_resolution_failed', 'dns_timeout', 'google_rate_limit',
'internal_verifier_error', 'm365_ip_rep_block', 'microsoft_api_error',
'microsoft_api_unavailable', 'mimecast_greylist',
'mx_only_verification_semaphore_timeout', 'policy_temp_fail',
'proofpoint_ad_lookup', 'rate_limited', 'smtp_550_unclassified',
'smtp_connection_failed', 'smtp_egress_unavailable', 'smtp_eof_blocked',
'smtp_greylisted', 'smtp_rate_check_failed', 'smtp_rate_limited',
'smtp_rate_wait_failed', 'smtp_timeout', 'unitedinternet_api_error',
'yahoo_api_eof', 'yahoo_api_error', 'yahoo_api_rate_limited',
'yahoo_api_unavailable',
]);
return result.status === 'unknown' && retryableReasons.has(result.reason);
}