Raisons de vérification

Chaque résultat de vérification inclut un champ reason qui explique pourquoi l'e-mail a reçu son statut. Utilisez cette référence pour construire une logique de filtrage précise, diagnostiquer des résultats inattendus et optimiser votre stratégie d'envoi.

Fonctionnement des raisons

Le champ reason apparaît dans toutes les réponses de vérification aux côtés du champ status :

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

Les raisons sont des identifiants de chaîne stables — vous pouvez les utiliser directement dans des règles de filtrage ou une logique conditionnelle en aval.

Valid (Valide)

Les e-mails avec status: "valid" sont confirmés livrables.

Invalid (Invalide)

Les e-mails avec status: "invalid" doivent être supprimés de votre liste — la livraison n'est pas possible.

Unknown (Inconnu)

Les e-mails avec status: "unknown" n'ont pas pu être vérifiés de manière concluante. Certains sont temporaires (récupérables) ; d'autres représentent des limitations structurelles.

Risky (Risqué)

Les e-mails avec status: "risky" peuvent presque toujours recevoir des messages, mais le domaine du destinataire figure sur une liste de blocage externe (Spamhaus Domain Blocklist) pour spam, hameçonnage, logiciels malveillants ou C&C de botnet. Leur envoyer des e-mails nuit à votre réputation d'expéditeur — traitez-les comme des adresses jetables et retirez-les de la liste.

Le tableau risk_reasons du résultat en explique la raison. Ces résultats sont facturés et ne sont jamais réessayables.

Les domaines que Spamhaus signale comme abused legitimate sites (un site web normal compromis) ne produisent jamais de résultat risky : le piratage du site d'une entreprise ne signifie pas que ses boîtes aux lettres posent problème.

Modifié le 2026-08-04. risky signifiait auparavant « nous n'avons pas pu terminer la vérification » (repli interne lié à la capacité SMTP) ; il était réessayable et gratuit. Ce cas est désormais renvoyé sous unknown avec le même motif mx_only_verification_semaphore_timeout, sans changement de comportement ni de facturation. Si votre intégration traite risky comme « réessayer plus tard », mettez-la à jour.

Catch-all

Les e-mails avec status: "catchall" appartiennent à des domaines qui acceptent le courrier pour toutes les adresses. La délivrabilité individuelle ne peut pas être confirmée.

Role (Adresse de rôle)

Les e-mails avec status: "role" appartiennent à des boîtes de réception partagées (p. ex. info@, support@, noreply@). Ces adresses sont généralement livrables mais ont un faible taux d'engagement.

Les adresses de rôle héritent du reason de leur vérification SMTP sous-jacente — aucun code de raison dédié n'existe pour ce statut. Par exemple, une adresse de rôle qui réussit SMTP affichera reason: "smtp_deliverable".

Disposable (Jetable)

Les e-mails avec status: "disposable" appartiennent à des services de messagerie temporaire. Accepter ceux-ci conduit généralement à des inscriptions de mauvaise qualité.

Utiliser les raisons dans le filtrage

Vous pouvez combiner status et reason pour une segmentation précise des listes. Par exemple, pour conserver les e-mails unknown qui ne sont inconnus qu'en raison de problèmes temporaires :

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);
}