Razones de Verificación

Cada resultado de verificación incluye un campo reason que explica por qué el correo electrónico recibió su estado. Use esta referencia para construir lógica de filtrado precisa, diagnosticar resultados inesperados y ajustar su 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 — puede usarlos directamente en reglas de filtrado o lógica condicional posterior.

Valid (Válido)

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

Invalid (Inválido)

Los correos con status: "invalid" deben eliminarse de su lista — la entrega no es posible.

Unknown (Desconocido)

Los correos con status: "unknown" no pudieron verificarse de forma concluyente. Algunos son temporales (reintentables); otros representan limitaciones estructurales.

Risky (Arriesgado)

Los correos con status: "risky" casi siempre pueden recibir mensajes, pero el dominio del destinatario figura en una lista de bloqueo externa (Spamhaus Domain Blocklist) por spam, phishing, malware o C&C de botnets. Enviarles correo daña tu reputación de envío — trátalos como direcciones desechables y elimínalos de la lista.

El array risk_reasons del resultado explica el motivo. Estos resultados se facturan y nunca son reintentables.

Los dominios que Spamhaus marca como abused legitimate sites (un sitio web normal que fue comprometido) nunca producen un resultado risky: que hayan hackeado el sitio de una empresa no significa que sus buzones sean problemáticos.

Cambiado el 2026-08-04. Antes risky significaba «no pudimos terminar la verificación» (un repliegue interno por capacidad SMTP), era reintentable y gratuito. Ese caso ahora se devuelve como unknown con el mismo motivo mx_only_verification_semaphore_timeout, sin cambios de comportamiento ni de facturación. Si tu integración trata risky como «reintentar más tarde», actualízala.

Catch-all

Los correos con status: "catchall" pertenecen a dominios que aceptan correo para todas las direcciones. La entregabilidad individual no puede confirmarse.

Role (Dirección de rol)

Los correos con status: "role" pertenecen a bandejas de entrada compartidas (p. ej. info@, support@, noreply@). Estas direcciones son típicamente entregables pero tienen baja tasa de interacción.

Las direcciones de rol heredan el reason de su verificación SMTP subyacente — no existen códigos de razón dedicados para este estado. Por ejemplo, una dirección de rol que pasa SMTP mostrará reason: "smtp_deliverable".

Disposable (Desechable)

Los correos con status: "disposable" pertenecen a servicios de correo temporal. Aceptar estos generalmente conduce a registros de baja calidad.

Usando razones en el filtrado

Puede combinar status y reason para una segmentación precisa de listas. Por ejemplo, para mantener correos unknown que solo son desconocidos debido a problemas temporales:

function isRetryableUnknown(result) {
  const retryableReasons = new Set([
    'smtp_eof_blocked', 'smtp_timeout', 'smtp_rate_limited',
    'smtp_greylisted', 'mimecast_greylist', 'proofpoint_ad_lookup',
    'policy_temp_fail', 'google_rate_limit', 'm365_ip_rep_block',
    'dns_timeout', 'dns_lookup_error', 'yahoo_api_error',
    'yahoo_api_unavailable', 'yahoo_api_eof',
    'yahoo_api_unavailable_after_fallback', 'internal_verifier_error',
    'rate_limited', 'mx_only_verification_semaphore_timeout',
  ]);
  return result.status === 'unknown' && retryableReasons.has(result.reason);
}