BillionVerify LogoBillionVerify

Razones de verificación

Referencia completa de todos los códigos de razón de verificación que devuelve la API de BillionVerify: qué significa cada uno y cómo actuar.

Mira cómo funciona

¿Cómo funciona la verificación de correo? Capa por capa

Cómo funciona la verificación de correo, de la sintaxis a SMTP: sigue una dirección por las nueve capas que deciden su resultado. Mira dónde se detienen antes las direcciones, cómo se lee la respuesta del servidor de correo, cómo se prueba el catch-all y qué cuesta cada resultado.

Cada resultado de verificación incluye un campo reason que explica por qué el email recibió su estado. Usa esta referencia para construir una lógica de filtrado precisa, diagnosticar resultados inesperados y ajustar tu estrategia de envío.

Cómo funcionan las razones

El campo reason aparece en todas las respuestas de verificación junto al campo status:

{
  "email": "user@example.com",
  "status": "valid",
  "reason": "smtp_deliverable"
}

Las razones son identificadores de cadena estables: puedes usarlas directamente en reglas de filtrado o en lógica condicional posterior.

Cómo se verifica cada tipo de buzón

La razón que obtienes depende de cómo se pueda comprobar el proveedor del destinatario:

  • Dominios de empresa (Google Workspace, Microsoft 365, servidores de correo propios) reciben una comprobación SMTP RCPT en vivo sobre el buzón exacto. Primero se sondea una dirección aleatoria del mismo dominio, de modo que los dominios catch-all, la retransmisión interna de Microsoft 365 y las pasarelas de seguridad en modo accept-all se informan como catchall en lugar de valid.
  • Gmail recibe una comprobación SMTP RCPT en vivo.
  • Yahoo, AOL, Outlook.com, Hotmail, Live y MSN bloquean la verificación por SMTP, por lo que se comprueban mediante consultas de cuenta específicas de cada proveedor. Estas devuelven razones yahoo_api_* o microsoft_api_* y confirman si la cuenta existe.
  • GMX, web.de, Mail.ru, Yandex y otros proveedores regionales se verifican con un ritmo propio de cada proveedor. Los límites de frecuencia, el greylisting y las comprobaciones rechazadas dan lugar a más resultados unknown.
  • Apple iCloud, Proton y Tuta no permiten ninguna comprobación fiable, por lo que sus direcciones siempre devuelven unknown con smtp_unverifiable.

Los resultados unknown nunca se facturan, sea cual sea la razón.

Válido

Los emails con status: "valid" están confirmados como entregables.

RazónDescripción
smtp_deliverableSMTP RCPT devolvió 250 OK: buzón confirmado como entregable. También se produce cuando el modo DBEB de Microsoft 365 confirma la entrega.
yahoo_api_verifiedLa consulta de cuenta de Yahoo o AOL confirmó que la cuenta existe.
microsoft_api_verifiedLa consulta de cuenta de consumidor de Microsoft (Outlook.com, Hotmail, Live, MSN) confirmó que la cuenta existe.
unitedinternet_api_verifiedLa consulta de cuenta de GMX.com / mail.com confirmó que la cuenta existe.

Inválido

Los emails con status: "invalid" deben eliminarse de tu lista: la entrega no es posible.

RazónDescripción
invalid_syntaxLa dirección de email no supera el análisis de sintaxis: parte local o dominio mal formados, o falta el @. Nunca se factura.
no_mx_recordsEl dominio no tiene registros MX (NXDOMAIN o resultado de consulta MX vacío).
null_mxEl dominio publica un registro MX nulo (RFC 7505): declara explícitamente que no acepta correo.
spf_reject_allEl dominio no tiene registros MX y tiene un registro SPF con -all: el dominio rechaza explícitamente todo el correo entrante.
mailbox_not_foundSMTP 550/5xx confirmó que el buzón no existe en el servidor remoto.
mailbox_disabledEl buzón existe, pero ha sido deshabilitado o desactivado.
host_not_foundEl nombre de host MX no respondió: host inalcanzable o inexistente.
yahoo_api_not_deliverableLa consulta de cuenta de Yahoo o AOL confirmó que la cuenta no existe.
microsoft_api_not_deliverableLa consulta de cuenta de consumidor de Microsoft confirmó que la cuenta no existe.
unitedinternet_api_not_deliverableLa consulta de cuenta de GMX.com / mail.com confirmó que la cuenta no existe.

Desconocido

Los emails con status: "unknown" no pudieron verificarse de forma concluyente. Los resultados desconocidos nunca se facturan. Algunos son temporales (reintentables); otros reflejan limitaciones estructurales.

RazónReintentableDescripción
smtp_unverifiableNoEl proveedor no permite una verificación SMTP fiable (Apple iCloud, Proton, Tuta).
smtp_blockedNoEl servidor SMTP remoto bloqueó o puso en lista negra la conexión de forma explícita.
smtp_eof_blockedSíEl MX cerró la conexión antes de enviar un banner: normalmente un limitador de frecuencia por IP o una regla de fail2ban.
smtp_timeoutSíLa operación SMTP agotó el tiempo de espera (plazo del contexto o cancelación).
smtp_connection_failedSíFallo genérico de conexión SMTP: no coincidió ninguna clase más específica.
smtp_rate_limitedSíEl servidor SMTP remoto devolvió una respuesta de límite de frecuencia (421, 450, 451 o límite de mensajes excedido).
smtp_greylistedSíSe detectó una respuesta genérica de greylisting: reintenta tras una espera.
smtp_550_unclassifiedSíEl servidor devolvió un 550 que no significa claramente «usuario desconocido», por lo que no se trata como inválido.
smtp_egress_unavailableSíNo había ninguna salida de verificación disponible para este proveedor en el momento de la comprobación.
smtp_egress_unselectableNoNinguna salida de verificación tiene permitido llegar a este proveedor.
mimecast_greylistSíGreylist específico de Mimecast / fallo temporal 451.
proofpoint_ad_lookupSíConsulta asíncrona de AD de Proofpoint en curso (fallo temporal 421 4.1.1 durante la validación del destinatario).
proofpoint_egress_listedNoDominio protegido por Proofpoint en el que, por ahora, no se responde a nuestras comprobaciones.
policy_temp_failSíFallo temporal genérico 4xx por la aplicación de políticas remotas.
google_rate_limitSíEl MX de Google devolvió una respuesta de límite de frecuencia o de rechazo temporal.
google_dmarc_misalignmentNoLa configuración DMARC del dominio está desalineada: Google rechaza según la política DMARC.
m365_ip_rep_blockSíMicrosoft 365 rechazó la conexión por la reputación de la IP (códigos 4.7.650 / 4.7.651).
tonline_egress_not_whitelistedNoT-Online solo acepta comprobaciones de remitentes de su lista de permitidos, por lo que el buzón no puede verificarse.
mailbox_fullNoEl buzón existe, pero ha superado su cuota (SMTP 452 o respuesta de bandeja de entrada llena).
dns_timeoutSíLa consulta DNS o MX agotó el tiempo de espera: problema transitorio del resolvedor.
dns_lookup_errorSíLa consulta DNS falló con un error distinto de NXDOMAIN (SERVFAIL, tiempo de espera UDP o error del resolvedor).
dns_resolution_failedSíLa resolución DNS falló por una causa transitoria.
yahoo_api_errorSíFalló la consulta de cuenta de Yahoo / AOL: error general.
yahoo_api_unavailableSíLa consulta de cuenta de Yahoo / AOL no estaba disponible (fallo de salud a nivel de lote).
yahoo_api_eofSíLa consulta de cuenta de Yahoo / AOL devolvió un EOF prematuro: corte transitorio de TCP/TLS.
yahoo_api_rate_limitedSíLa consulta de cuenta de Yahoo / AOL fue limitada por frecuencia.
microsoft_api_errorSíLa consulta de cuenta de consumidor de Microsoft falló o fue limitada.
microsoft_api_unavailableSíLa consulta de cuenta de consumidor de Microsoft no estaba disponible.
unitedinternet_api_errorSíFalló la consulta de cuenta de GMX.com / mail.com.
unitedinternet_api_unavailableNoLa consulta de cuenta de GMX.com / mail.com no estuvo disponible en esta ejecución.
capacity_deferredSíLa capacidad de verificación del proveedor estaba llena, por lo que la comprobación se aplazó.
provider_capacity_exhaustedNoLa capacidad del proveedor siguió llena durante toda la ventana de reintentos (unas dos horas), por lo que el trabajo terminó sin conclusión para estas direcciones.
carrier_blockedNoDominio de operador japonés (docomo.ne.jp, au.com, etc.): la política del operador bloquea SMTP.
internal_verifier_errorSíError interno del verificador sin clasificar: fallo transitorio.
rate_limitedSíEl email fue limitado por frecuencia durante el procesamiento por lotes (alias de smtp_rate_limited en trabajos de archivo).
bucket_default_skip_smtp_unknownNoEl modo de verificación a nivel de cuenta está configurado para omitir SMTP: el resultado se basa solo en comprobaciones de dominio.
mx_only_verification_semaphore_timeoutSíSe agotó el tiempo del semáforo de concurrencia SMTP: la alternativa solo-MX confirmó registros MX válidos, pero no pudo verificarse el buzón de forma individual.

Catch-all

Los emails con status: "catchall" pertenecen a dominios que aceptan correo para todas las direcciones. No se puede confirmar la entregabilidad individual.

RazónDescripción
catch_all_domainDominio confirmado como catch-all: el servidor de correo aceptó una sonda RCPT aleatoria.
catch_all_deliverableDominio catch-all, y la dirección concreta también devolvió 250 OK en RCPT.
catch_all_inferredEstado catch-all inferido a partir de evidencia en caché (indirecta, no una sonda en vivo).
m365_internal_relayDominio de Microsoft 365 configurado como retransmisión interna: se aceptan todos los RCPT, pero no se verifican de forma individual.
gateway_accept_allLa pasarela de seguridad (Mimecast, Proofpoint, etc.) está en modo accept-all.
forwarding_aliasServicio de alias de reenvío de email (SimpleLogin, Firefox Relay, Duck.com).
yahoo_isp_accept_allDominio de ISP alojado en la infraestructura de correo de Yahoo (por ejemplo att.net, sbcglobal.net, verizon.net): el proveedor acepta a todos los destinatarios, por lo que no es posible una comprobación a nivel de buzón.
region_consumer_accept_allDominio de consumidor regional que se sabe que acepta todo el correo entrante (resultados antiguos).
bucket_default_skip_smtp_catchallEl modo de verificación a nivel de cuenta está configurado para omitir la detección catch-all por SMTP.

De rol

Los emails con status: "role" pertenecen a buzones compartidos (p. ej. info@, support@, noreply@). Estas direcciones suelen ser entregables, pero tienen poca interacción.

Las direcciones de rol heredan el reason de su comprobación SMTP de base: no existen códigos de razón propios para este estado. Por ejemplo, una dirección de rol que supera SMTP mostrará reason: "smtp_deliverable".

Desechable

Los emails con status: "disposable" pertenecen a servicios de email temporal. Aceptarlos suele dar lugar a registros de baja calidad.

RazónDescripción
disposable_domainEl dominio figura como proveedor de email desechable / temporal conocido.

Arriesgado (solo resultados antiguos)

Las verificaciones nuevas ya no devuelven status: "risky". Su única fuente, la comprobación de la Spamhaus Domain Blocklist, se eliminó el 2026-09-11. Todavía puedes ver risky en resultados creados antes de esa fecha.

En esos resultados antiguos, risky significaba que la dirección era con toda probabilidad entregable, pero el dominio del destinatario figuraba en Spamhaus por actividad de spam, phishing, malware o C&C de botnets. El array risk_reasons explica el motivo:

Valor de risk_reasonsDescripción
spamhaus_dbl_spamEl dominio figura como fuente de spam.
spamhaus_dbl_phishEl dominio figura como dominio de phishing.
spamhaus_dbl_malwareEl dominio figura como dominio de distribución de malware.
spamhaus_dbl_botnet_ccEl dominio figura como infraestructura de mando y control de botnets.

Usar las razones en el filtrado

Puedes combinar status y reason para segmentar listas con precisión. Por ejemplo, para conservar los emails unknown que solo lo son por problemas temporales:

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