BillionVerify LogoBillionVerify

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 como valid.
  • 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_* ou microsoft_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 unknown com smtp_unverifiable.

Resultados unknown nunca são cobrados, seja qual for o motivo.

Válido

Emails com status: "valid" têm a entrega confirmada.

MotivoDescrição
smtp_deliverableO 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_verifiedA consulta de conta do Yahoo ou da AOL confirmou que a conta existe.
microsoft_api_verifiedA consulta de conta pessoal da Microsoft (Outlook.com, Hotmail, Live, MSN) confirmou que a conta existe.
unitedinternet_api_verifiedA 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.

MotivoDescrição
invalid_syntaxO endereço de email falha na análise de sintaxe: parte local ou domínio malformado, ou @ ausente. Nunca é cobrado.
no_mx_recordsO domínio não tem registros MX (NXDOMAIN ou consulta MX com resultado vazio).
null_mxO domínio publica um registro null MX (RFC 7505): ele declara explicitamente que não aceita mensagens.
spf_reject_allO 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_foundO SMTP 550/5xx confirmou que a caixa postal não existe no servidor remoto.
mailbox_disabledA caixa postal existe, mas foi desativada.
host_not_foundO hostname do MX não respondeu: host inacessível ou inexistente.
yahoo_api_not_deliverableA consulta de conta do Yahoo ou da AOL confirmou que a conta não existe.
microsoft_api_not_deliverableA consulta de conta pessoal da Microsoft confirmou que a conta não existe.
unitedinternet_api_not_deliverableA 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.

MotivoNova tentativaDescrição
smtp_unverifiableNãoO provedor não permite nenhuma verificação SMTP confiável (Apple iCloud, Proton, Tuta).
smtp_blockedNãoO servidor SMTP remoto bloqueou explicitamente a conexão ou a colocou em lista de bloqueio.
smtp_eof_blockedSimO 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_timeoutSimA operação SMTP expirou (prazo do contexto ou cancelamento).
smtp_connection_failedSimFalha genérica de conexão SMTP: nenhuma classe mais específica correspondeu.
smtp_rate_limitedSimO servidor SMTP remoto retornou uma resposta de limite de taxa (421, 450, 451 ou limite de mensagens excedido).
smtp_greylistedSimResposta genérica de greylisting detectada: tente de novo após um intervalo.
smtp_550_unclassifiedSimO servidor retornou um 550 que não significa claramente "usuário desconhecido", por isso não é tratado como inválido.
smtp_egress_unavailableSimNenhuma saída de verificação estava disponível para este provedor no momento da checagem.
smtp_egress_unselectableNãoNenhuma saída de verificação tem permissão para alcançar este provedor.
mimecast_greylistSimGreylist / falha temporária 451 específica da Mimecast.
proofpoint_ad_lookupSimConsulta assíncrona ao AD da Proofpoint em andamento (falha temporária 421 4.1.1 durante a validação do destinatário).
proofpoint_egress_listedNãoDomínio protegido pela Proofpoint em que as nossas verificações não estão sendo respondidas no momento.
policy_temp_failSimFalha temporária 4xx genérica da aplicação de política remota.
google_rate_limitSimO MX do Google retornou uma resposta de limite de taxa ou de rejeição temporária.
google_dmarc_misalignmentNãoA configuração DMARC do domínio está desalinhada: o Google rejeita com base na política DMARC.
m365_ip_rep_blockSimO Microsoft 365 rejeitou a conexão por causa da reputação do IP (códigos 4.7.650 / 4.7.651).
tonline_egress_not_whitelistedNãoA T-Online só aceita verificações de remetentes em lista de permissão, então a caixa postal não pode ser verificada.
mailbox_fullNãoA caixa postal existe, mas excedeu a cota (SMTP 452 ou resposta de caixa de entrada cheia).
dns_timeoutSimA consulta de DNS ou de MX expirou: problema transitório do resolvedor.
dns_lookup_errorSimA consulta de DNS falhou com um erro diferente de NXDOMAIN (SERVFAIL, timeout de UDP ou erro do resolvedor).
dns_resolution_failedSimA resolução de DNS falhou por um motivo transitório.
yahoo_api_errorSimA consulta de conta do Yahoo / AOL falhou: erro geral.
yahoo_api_unavailableSimA consulta de conta do Yahoo / AOL estava indisponível (falha de saúde em nível de lote).
yahoo_api_eofSimA consulta de conta do Yahoo / AOL retornou EOF antecipado: queda transitória de TCP/TLS.
yahoo_api_rate_limitedSimA consulta de conta do Yahoo / AOL sofreu limite de taxa.
microsoft_api_errorSimA consulta de conta pessoal da Microsoft falhou ou foi limitada.
microsoft_api_unavailableSimA consulta de conta pessoal da Microsoft estava indisponível.
unitedinternet_api_errorSimA consulta de conta do GMX.com / mail.com falhou.
unitedinternet_api_unavailableNãoA consulta de conta do GMX.com / mail.com estava indisponível nesta execução.
capacity_deferredSimA capacidade de verificação do provedor estava cheia, então a checagem foi adiada.
provider_capacity_exhaustedNãoA 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_blockedNãoDomínio de operadora japonesa (docomo.ne.jp, au.com etc.): o SMTP é bloqueado pela política da operadora.
internal_verifier_errorSimErro interno do verificador não classificado: falha transitória.
rate_limitedSimO email sofreu limite de taxa durante o processamento em lote (alias de smtp_rate_limited em trabalhos com arquivo).
bucket_default_skip_smtp_unknownNãoO 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_timeoutSimO 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.

MotivoDescrição
catch_all_domainDomínio confirmado como catch-all: a sonda RCPT aleatória foi aceita pelo servidor de email.
catch_all_deliverableDomínio catch-all, e o endereço específico também retornou 250 OK no RCPT.
catch_all_inferredStatus catch-all inferido a partir de evidências em cache (indireto, não é uma sonda ao vivo).
m365_internal_relayDomínio do Microsoft 365 configurado como relay interno: todos os RCPT foram aceitos, mas não verificados individualmente.
gateway_accept_allO gateway de segurança (Mimecast, Proofpoint etc.) está em modo accept-all.
forwarding_aliasServiço de alias de encaminhamento de email (SimpleLogin, Firefox Relay, Duck.com).
yahoo_isp_accept_allDomí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_allDomínio regional de consumidor conhecido por aceitar todas as mensagens recebidas (resultados mais antigos).
bucket_default_skip_smtp_catchallO 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.

MotivoDescrição
disposable_domainO 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_reasonsDescrição
spamhaus_dbl_spamO domínio consta como fonte de spam.
spamhaus_dbl_phishO domínio consta como domínio de phishing.
spamhaus_dbl_malwareO domínio consta como domínio de distribuição de malware.
spamhaus_dbl_botnet_ccO 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);
}

On this page