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
catchallen lugar devalid. - 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_*omicrosoft_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
unknownconsmtp_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ón | Descripción |
|---|---|
smtp_deliverable | SMTP 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_verified | La consulta de cuenta de Yahoo o AOL confirmó que la cuenta existe. |
microsoft_api_verified | La consulta de cuenta de consumidor de Microsoft (Outlook.com, Hotmail, Live, MSN) confirmó que la cuenta existe. |
unitedinternet_api_verified | La 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ón | Descripción |
|---|---|
invalid_syntax | La 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_records | El dominio no tiene registros MX (NXDOMAIN o resultado de consulta MX vacío). |
null_mx | El dominio publica un registro MX nulo (RFC 7505): declara explícitamente que no acepta correo. |
spf_reject_all | El dominio no tiene registros MX y tiene un registro SPF con -all: el dominio rechaza explícitamente todo el correo entrante. |
mailbox_not_found | SMTP 550/5xx confirmó que el buzón no existe en el servidor remoto. |
mailbox_disabled | El buzón existe, pero ha sido deshabilitado o desactivado. |
host_not_found | El nombre de host MX no respondió: host inalcanzable o inexistente. |
yahoo_api_not_deliverable | La consulta de cuenta de Yahoo o AOL confirmó que la cuenta no existe. |
microsoft_api_not_deliverable | La consulta de cuenta de consumidor de Microsoft confirmó que la cuenta no existe. |
unitedinternet_api_not_deliverable | La 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ón | Reintentable | Descripción |
|---|---|---|
smtp_unverifiable | No | El proveedor no permite una verificación SMTP fiable (Apple iCloud, Proton, Tuta). |
smtp_blocked | No | El servidor SMTP remoto bloqueó o puso en lista negra la conexión de forma explícita. |
smtp_eof_blocked | Sí | El MX cerró la conexión antes de enviar un banner: normalmente un limitador de frecuencia por IP o una regla de fail2ban. |
smtp_timeout | Sí | La operación SMTP agotó el tiempo de espera (plazo del contexto o cancelación). |
smtp_connection_failed | Sí | Fallo genérico de conexión SMTP: no coincidió ninguna clase más específica. |
smtp_rate_limited | Sí | El servidor SMTP remoto devolvió una respuesta de límite de frecuencia (421, 450, 451 o límite de mensajes excedido). |
smtp_greylisted | Sí | Se detectó una respuesta genérica de greylisting: reintenta tras una espera. |
smtp_550_unclassified | Sí | El servidor devolvió un 550 que no significa claramente «usuario desconocido», por lo que no se trata como inválido. |
smtp_egress_unavailable | Sí | No había ninguna salida de verificación disponible para este proveedor en el momento de la comprobación. |
smtp_egress_unselectable | No | Ninguna salida de verificación tiene permitido llegar a este proveedor. |
mimecast_greylist | Sí | Greylist específico de Mimecast / fallo temporal 451. |
proofpoint_ad_lookup | Sí | Consulta asíncrona de AD de Proofpoint en curso (fallo temporal 421 4.1.1 durante la validación del destinatario). |
proofpoint_egress_listed | No | Dominio protegido por Proofpoint en el que, por ahora, no se responde a nuestras comprobaciones. |
policy_temp_fail | Sí | Fallo temporal genérico 4xx por la aplicación de políticas remotas. |
google_rate_limit | Sí | El MX de Google devolvió una respuesta de límite de frecuencia o de rechazo temporal. |
google_dmarc_misalignment | No | La configuración DMARC del dominio está desalineada: Google rechaza según la política DMARC. |
m365_ip_rep_block | Sí | Microsoft 365 rechazó la conexión por la reputación de la IP (códigos 4.7.650 / 4.7.651). |
tonline_egress_not_whitelisted | No | T-Online solo acepta comprobaciones de remitentes de su lista de permitidos, por lo que el buzón no puede verificarse. |
mailbox_full | No | El buzón existe, pero ha superado su cuota (SMTP 452 o respuesta de bandeja de entrada llena). |
dns_timeout | Sí | La consulta DNS o MX agotó el tiempo de espera: problema transitorio del resolvedor. |
dns_lookup_error | Sí | La consulta DNS falló con un error distinto de NXDOMAIN (SERVFAIL, tiempo de espera UDP o error del resolvedor). |
dns_resolution_failed | Sí | La resolución DNS falló por una causa transitoria. |
yahoo_api_error | Sí | Falló la consulta de cuenta de Yahoo / AOL: error general. |
yahoo_api_unavailable | Sí | La consulta de cuenta de Yahoo / AOL no estaba disponible (fallo de salud a nivel de lote). |
yahoo_api_eof | Sí | La consulta de cuenta de Yahoo / AOL devolvió un EOF prematuro: corte transitorio de TCP/TLS. |
yahoo_api_rate_limited | Sí | La consulta de cuenta de Yahoo / AOL fue limitada por frecuencia. |
microsoft_api_error | Sí | La consulta de cuenta de consumidor de Microsoft falló o fue limitada. |
microsoft_api_unavailable | Sí | La consulta de cuenta de consumidor de Microsoft no estaba disponible. |
unitedinternet_api_error | Sí | Falló la consulta de cuenta de GMX.com / mail.com. |
unitedinternet_api_unavailable | No | La consulta de cuenta de GMX.com / mail.com no estuvo disponible en esta ejecución. |
capacity_deferred | Sí | La capacidad de verificación del proveedor estaba llena, por lo que la comprobación se aplazó. |
provider_capacity_exhausted | No | La 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_blocked | No | Dominio de operador japonés (docomo.ne.jp, au.com, etc.): la política del operador bloquea SMTP. |
internal_verifier_error | Sí | Error interno del verificador sin clasificar: fallo transitorio. |
rate_limited | Sí | El email fue limitado por frecuencia durante el procesamiento por lotes (alias de smtp_rate_limited en trabajos de archivo). |
bucket_default_skip_smtp_unknown | No | El 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_timeout | Sí | 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ón | Descripción |
|---|---|
catch_all_domain | Dominio confirmado como catch-all: el servidor de correo aceptó una sonda RCPT aleatoria. |
catch_all_deliverable | Dominio catch-all, y la dirección concreta también devolvió 250 OK en RCPT. |
catch_all_inferred | Estado catch-all inferido a partir de evidencia en caché (indirecta, no una sonda en vivo). |
m365_internal_relay | Dominio de Microsoft 365 configurado como retransmisión interna: se aceptan todos los RCPT, pero no se verifican de forma individual. |
gateway_accept_all | La pasarela de seguridad (Mimecast, Proofpoint, etc.) está en modo accept-all. |
forwarding_alias | Servicio de alias de reenvío de email (SimpleLogin, Firefox Relay, Duck.com). |
yahoo_isp_accept_all | Dominio 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_all | Dominio de consumidor regional que se sabe que acepta todo el correo entrante (resultados antiguos). |
bucket_default_skip_smtp_catchall | El 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ón | Descripción |
|---|---|
disposable_domain | El 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_reasons | Descripción |
|---|---|
spamhaus_dbl_spam | El dominio figura como fuente de spam. |
spamhaus_dbl_phish | El dominio figura como dominio de phishing. |
spamhaus_dbl_malware | El dominio figura como dominio de distribución de malware. |
spamhaus_dbl_botnet_cc | El 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);
}