Raisons de vérification
Référence complète de tous les codes reason de vérification renvoyés par l'API BillionVerify : ce que signifie chaque raison et comment agir en conséquence.
Voyez comment ça marche
Comment fonctionne la vérification d'e-mails ? Couche par couche
Comment fonctionne la vérification d'e-mails, de la syntaxe à SMTP : suivez une adresse à travers les neuf couches qui décident de son résultat. Voyez où les adresses s'arrêtent tôt, comment la réponse du serveur de messagerie est lue, comment le catch-all est testé et ce que coûte chaque résultat.
Chaque résultat de vérification inclut un champ reason qui explique pourquoi l'email a reçu son statut. Utilisez cette référence pour construire une logique de filtrage précise, diagnostiquer des résultats inattendus et affiner votre stratégie d'envoi.
Fonctionnement des raisons
Le champ reason apparaît dans toutes les réponses de vérification, à côté 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 dans une logique conditionnelle en aval.
Comment chaque type de boîte est vérifié
La raison que vous obtenez dépend de la façon dont le fournisseur du destinataire peut être contrôlé :
- Les domaines d'entreprise (Google Workspace, Microsoft 365, serveurs de messagerie auto-hébergés) font l'objet d'un contrôle SMTP RCPT en direct sur la boîte exacte. Une adresse aléatoire du même domaine est sondée d'abord : les domaines catch-all, le relais interne de Microsoft 365 et les passerelles de sécurité en mode accept-all sont donc signalés comme
catchallplutôt quevalid. - Gmail fait l'objet d'un contrôle SMTP RCPT en direct.
- Yahoo, AOL, Outlook.com, Hotmail, Live et MSN bloquent la vérification SMTP : ils sont donc contrôlés par des recherches de compte propres à chaque fournisseur. Ces recherches renvoient des raisons
yahoo_api_*oumicrosoft_api_*et confirment si le compte existe. - GMX, web.de, Mail.ru, Yandex et d'autres fournisseurs régionaux sont vérifiés avec une cadence propre à chaque fournisseur. Les limites de débit, le greylisting et les contrôles refusés entraînent davantage de résultats
unknown. - Apple iCloud, Proton et Tuta n'autorisent aucun contrôle fiable : leurs adresses renvoient toujours
unknownavecsmtp_unverifiable.
Les résultats unknown ne sont jamais facturés, quelle que soit la raison.
Valid (Valide)
Les emails avec status: "valid" sont confirmés livrables.
| Raison | Description |
|---|---|
smtp_deliverable | SMTP RCPT a renvoyé 250 OK — boîte aux lettres confirmée livrable. Également produit lorsque le mode DBEB de Microsoft 365 confirme la livraison. |
yahoo_api_verified | La recherche de compte Yahoo ou AOL a confirmé que le compte existe. |
microsoft_api_verified | La recherche de compte grand public Microsoft (Outlook.com, Hotmail, Live, MSN) a confirmé que le compte existe. |
unitedinternet_api_verified | La recherche de compte GMX.com / mail.com a confirmé que le compte existe. |
Invalid (Invalide)
Les emails avec status: "invalid" doivent être retirés de votre liste — la livraison est impossible.
| Raison | Description |
|---|---|
invalid_syntax | L'adresse email échoue à l'analyse syntaxique — partie locale ou domaine malformé, ou @ manquant. Jamais facturée. |
no_mx_records | Le domaine n'a aucun enregistrement MX (NXDOMAIN ou résultat de recherche MX vide). |
null_mx | Le domaine publie un enregistrement MX nul (RFC 7505) — il n'accepte explicitement aucun courrier. |
spf_reject_all | Le domaine n'a aucun enregistrement MX et un enregistrement SPF avec -all — le domaine rejette explicitement tout le courrier entrant. |
mailbox_not_found | SMTP 550/5xx a confirmé que la boîte aux lettres n'existe pas sur le serveur distant. |
mailbox_disabled | La boîte aux lettres existe mais a été désactivée. |
host_not_found | Le nom d'hôte MX n'a pas répondu — hôte injoignable ou inexistant. |
yahoo_api_not_deliverable | La recherche de compte Yahoo ou AOL a confirmé que le compte n'existe pas. |
microsoft_api_not_deliverable | La recherche de compte grand public Microsoft a confirmé que le compte n'existe pas. |
unitedinternet_api_not_deliverable | La recherche de compte GMX.com / mail.com a confirmé que le compte n'existe pas. |
Unknown (Inconnu)
Les emails avec status: "unknown" n'ont pas pu être vérifiés de façon concluante. Les résultats inconnus ne sont jamais facturés. Certains sont temporaires (réessayables) ; d'autres traduisent des limites structurelles.
| Raison | Réessayable | Description |
|---|---|---|
smtp_unverifiable | Non | Le fournisseur n'autorise aucune vérification SMTP fiable (Apple iCloud, Proton, Tuta). |
smtp_blocked | Non | Le serveur SMTP distant a explicitement bloqué la connexion ou l'a mise sur liste noire. |
smtp_eof_blocked | Oui | Le MX a fermé la connexion avant d'envoyer une bannière — en général un limiteur de débit par IP ou une règle fail2ban. |
smtp_timeout | Oui | L'opération SMTP a expiré (délai du contexte ou annulation). |
smtp_connection_failed | Oui | Échec générique de connexion SMTP — aucune classe plus spécifique ne correspond. |
smtp_rate_limited | Oui | Le serveur SMTP distant a renvoyé une réponse de limitation de débit (421, 450, 451 ou limite de messages dépassée). |
smtp_greylisted | Oui | Réponse générique de greylisting détectée — réessayez après un délai. |
smtp_550_unclassified | Oui | Le serveur a renvoyé un 550 dont le sens n'est pas clairement « utilisateur inconnu » : il n'est donc pas traité comme invalide. |
smtp_egress_unavailable | Oui | Aucune sortie de vérification n'était disponible pour ce fournisseur au moment du contrôle. |
smtp_egress_unselectable | Non | Aucune sortie de vérification n'est autorisée à joindre ce fournisseur. |
mimecast_greylist | Oui | Greylisting propre à Mimecast / échec temporaire 451. |
proofpoint_ad_lookup | Oui | Recherche AD asynchrone Proofpoint en cours (échec temporaire 421 4.1.1 pendant la validation du destinataire). |
proofpoint_egress_listed | Non | Domaine protégé par Proofpoint auprès duquel nos contrôles restent actuellement sans réponse. |
policy_temp_fail | Oui | Échec temporaire générique 4xx dû à l'application d'une politique distante. |
google_rate_limit | Oui | Le MX de Google a renvoyé une réponse de limitation de débit ou de rejet temporaire. |
google_dmarc_misalignment | Non | La configuration DMARC du domaine est mal alignée — Google rejette selon la politique DMARC. |
m365_ip_rep_block | Oui | Microsoft 365 a rejeté la connexion en raison de la réputation de l'IP (codes 4.7.650 / 4.7.651). |
tonline_egress_not_whitelisted | Non | T-Online n'accepte les contrôles que d'expéditeurs autorisés : la boîte ne peut donc pas être vérifiée. |
mailbox_full | Non | La boîte aux lettres existe mais dépasse son quota (SMTP 452 ou réponse de boîte pleine). |
dns_timeout | Oui | La recherche DNS ou MX a expiré — problème transitoire du résolveur. |
dns_lookup_error | Oui | La recherche DNS a échoué avec une erreur autre que NXDOMAIN (SERVFAIL, délai UDP dépassé ou erreur du résolveur). |
dns_resolution_failed | Oui | La résolution DNS a échoué pour une raison transitoire. |
yahoo_api_error | Oui | La recherche de compte Yahoo / AOL a échoué — erreur générale. |
yahoo_api_unavailable | Oui | La recherche de compte Yahoo / AOL était indisponible (défaillance de santé au niveau du lot). |
yahoo_api_eof | Oui | La recherche de compte Yahoo / AOL a renvoyé un EOF prématuré — coupure TCP/TLS transitoire. |
yahoo_api_rate_limited | Oui | La recherche de compte Yahoo / AOL a été limitée en débit. |
microsoft_api_error | Oui | La recherche de compte grand public Microsoft a échoué ou a été limitée. |
microsoft_api_unavailable | Oui | La recherche de compte grand public Microsoft était indisponible. |
unitedinternet_api_error | Oui | La recherche de compte GMX.com / mail.com a échoué. |
unitedinternet_api_unavailable | Non | La recherche de compte GMX.com / mail.com était indisponible pour cette exécution. |
capacity_deferred | Oui | La capacité de vérification du fournisseur était saturée : le contrôle a été reporté. |
provider_capacity_exhausted | Non | La capacité du fournisseur est restée saturée pendant toute la fenêtre de nouvelles tentatives (environ deux heures) : la tâche s'est donc terminée sans conclusion pour ces adresses. |
carrier_blocked | Non | Domaine d'opérateur japonais (docomo.ne.jp, au.com, etc.) — SMTP est bloqué par la politique de l'opérateur. |
internal_verifier_error | Oui | Erreur interne non classifiée du vérificateur — défaillance transitoire. |
rate_limited | Oui | L'email a été limité en débit pendant le traitement par lots (alias de smtp_rate_limited dans les tâches sur fichier). |
bucket_default_skip_smtp_unknown | Non | Le mode de vérification du compte est réglé pour ignorer SMTP — le résultat repose uniquement sur les contrôles de domaine. |
mx_only_verification_semaphore_timeout | Oui | Le sémaphore de concurrence SMTP a expiré — le repli MX-only a confirmé des enregistrements MX valides, mais la boîte n'a pas pu être vérifiée individuellement. |
Catch-all
Les emails avec status: "catchall" appartiennent à des domaines qui acceptent le courrier pour toutes les adresses. La livrabilité de chaque adresse ne peut pas être confirmée.
| Raison | Description |
|---|---|
catch_all_domain | Domaine confirmé comme catch-all — sonde RCPT aléatoire acceptée par le serveur de messagerie. |
catch_all_deliverable | Domaine catch-all, et l'adresse précise a elle aussi renvoyé 250 OK sur RCPT. |
catch_all_inferred | Statut catch-all déduit d'éléments en cache (indirect, pas une sonde en direct). |
m365_internal_relay | Domaine Microsoft 365 configuré en relais interne — tous les RCPT sont acceptés mais non vérifiés individuellement. |
gateway_accept_all | La passerelle de sécurité (Mimecast, Proofpoint, etc.) est en mode accept-all. |
forwarding_alias | Service d'alias de redirection d'email (SimpleLogin, Firefox Relay, Duck.com). |
yahoo_isp_accept_all | Domaine de fournisseur d'accès hébergé sur l'infrastructure de messagerie Yahoo (par exemple att.net, sbcglobal.net, verizon.net) — le fournisseur accepte tous les destinataires : aucun contrôle au niveau de la boîte n'est donc possible. |
region_consumer_accept_all | Domaine grand public régional connu pour accepter tout le courrier entrant (anciens résultats). |
bucket_default_skip_smtp_catchall | Le mode de vérification du compte est réglé pour ignorer la détection catch-all SMTP. |
Role (Adresse de rôle)
Les emails avec status: "role" appartiennent à des boîtes partagées (par exemple info@, support@, noreply@). Ces adresses sont en général livrables, mais leur engagement est faible.
Les adresses de rôle héritent du reason de leur contrôle SMTP sous-jacent — aucun code reason dédié n'existe pour ce statut. Par exemple, une adresse de rôle qui réussit le contrôle SMTP affichera reason: "smtp_deliverable".
Disposable (Jetable)
Les emails avec status: "disposable" appartiennent à des services d'email temporaire. Les accepter conduit généralement à des inscriptions de faible qualité.
| Raison | Description |
|---|---|
disposable_domain | Le domaine figure sur la liste des fournisseurs d'email jetable / temporaire connus. |
Risky (Risqué, anciens résultats uniquement)
Les nouvelles vérifications ne renvoient plus status: "risky". Sa seule source, le contrôle Spamhaus Domain Blocklist, a été supprimée le 2026-09-11. Vous pouvez encore voir risky sur des résultats créés avant cette date.
Sur ces anciens résultats, risky signifiait que l'adresse était très probablement livrable, mais que le domaine du destinataire figurait chez Spamhaus pour des activités de spam, d'hameçonnage, de logiciels malveillants ou de C&C de botnet. Le tableau risk_reasons en donne la raison :
Valeur de risk_reasons | Description |
|---|---|
spamhaus_dbl_spam | Le domaine est répertorié comme source de spam. |
spamhaus_dbl_phish | Le domaine est répertorié comme domaine d'hameçonnage. |
spamhaus_dbl_malware | Le domaine est répertorié comme domaine de diffusion de logiciels malveillants. |
spamhaus_dbl_botnet_cc | Le domaine est répertorié comme infrastructure de commande et contrôle de botnet. |
Utiliser les raisons pour filtrer
Vous pouvez combiner status et reason pour segmenter vos listes avec précision. Par exemple, pour conserver les emails unknown qui ne le sont qu'à cause de problèmes temporaires :
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);
}