BillionVerify LogoBillionVerify

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 catchall plutôt que valid.
  • 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_* ou microsoft_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 unknown avec smtp_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.

RaisonDescription
smtp_deliverableSMTP 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_verifiedLa recherche de compte Yahoo ou AOL a confirmé que le compte existe.
microsoft_api_verifiedLa recherche de compte grand public Microsoft (Outlook.com, Hotmail, Live, MSN) a confirmé que le compte existe.
unitedinternet_api_verifiedLa 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.

RaisonDescription
invalid_syntaxL'adresse email échoue à l'analyse syntaxique — partie locale ou domaine malformé, ou @ manquant. Jamais facturée.
no_mx_recordsLe domaine n'a aucun enregistrement MX (NXDOMAIN ou résultat de recherche MX vide).
null_mxLe domaine publie un enregistrement MX nul (RFC 7505) — il n'accepte explicitement aucun courrier.
spf_reject_allLe domaine n'a aucun enregistrement MX et un enregistrement SPF avec -all — le domaine rejette explicitement tout le courrier entrant.
mailbox_not_foundSMTP 550/5xx a confirmé que la boîte aux lettres n'existe pas sur le serveur distant.
mailbox_disabledLa boîte aux lettres existe mais a été désactivée.
host_not_foundLe nom d'hôte MX n'a pas répondu — hôte injoignable ou inexistant.
yahoo_api_not_deliverableLa recherche de compte Yahoo ou AOL a confirmé que le compte n'existe pas.
microsoft_api_not_deliverableLa recherche de compte grand public Microsoft a confirmé que le compte n'existe pas.
unitedinternet_api_not_deliverableLa 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.

RaisonRéessayableDescription
smtp_unverifiableNonLe fournisseur n'autorise aucune vérification SMTP fiable (Apple iCloud, Proton, Tuta).
smtp_blockedNonLe serveur SMTP distant a explicitement bloqué la connexion ou l'a mise sur liste noire.
smtp_eof_blockedOuiLe 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_timeoutOuiL'opération SMTP a expiré (délai du contexte ou annulation).
smtp_connection_failedOuiÉchec générique de connexion SMTP — aucune classe plus spécifique ne correspond.
smtp_rate_limitedOuiLe serveur SMTP distant a renvoyé une réponse de limitation de débit (421, 450, 451 ou limite de messages dépassée).
smtp_greylistedOuiRéponse générique de greylisting détectée — réessayez après un délai.
smtp_550_unclassifiedOuiLe serveur a renvoyé un 550 dont le sens n'est pas clairement « utilisateur inconnu » : il n'est donc pas traité comme invalide.
smtp_egress_unavailableOuiAucune sortie de vérification n'était disponible pour ce fournisseur au moment du contrôle.
smtp_egress_unselectableNonAucune sortie de vérification n'est autorisée à joindre ce fournisseur.
mimecast_greylistOuiGreylisting propre à Mimecast / échec temporaire 451.
proofpoint_ad_lookupOuiRecherche AD asynchrone Proofpoint en cours (échec temporaire 421 4.1.1 pendant la validation du destinataire).
proofpoint_egress_listedNonDomaine protégé par Proofpoint auprès duquel nos contrôles restent actuellement sans réponse.
policy_temp_failOuiÉchec temporaire générique 4xx dû à l'application d'une politique distante.
google_rate_limitOuiLe MX de Google a renvoyé une réponse de limitation de débit ou de rejet temporaire.
google_dmarc_misalignmentNonLa configuration DMARC du domaine est mal alignée — Google rejette selon la politique DMARC.
m365_ip_rep_blockOuiMicrosoft 365 a rejeté la connexion en raison de la réputation de l'IP (codes 4.7.650 / 4.7.651).
tonline_egress_not_whitelistedNonT-Online n'accepte les contrôles que d'expéditeurs autorisés : la boîte ne peut donc pas être vérifiée.
mailbox_fullNonLa boîte aux lettres existe mais dépasse son quota (SMTP 452 ou réponse de boîte pleine).
dns_timeoutOuiLa recherche DNS ou MX a expiré — problème transitoire du résolveur.
dns_lookup_errorOuiLa recherche DNS a échoué avec une erreur autre que NXDOMAIN (SERVFAIL, délai UDP dépassé ou erreur du résolveur).
dns_resolution_failedOuiLa résolution DNS a échoué pour une raison transitoire.
yahoo_api_errorOuiLa recherche de compte Yahoo / AOL a échoué — erreur générale.
yahoo_api_unavailableOuiLa recherche de compte Yahoo / AOL était indisponible (défaillance de santé au niveau du lot).
yahoo_api_eofOuiLa recherche de compte Yahoo / AOL a renvoyé un EOF prématuré — coupure TCP/TLS transitoire.
yahoo_api_rate_limitedOuiLa recherche de compte Yahoo / AOL a été limitée en débit.
microsoft_api_errorOuiLa recherche de compte grand public Microsoft a échoué ou a été limitée.
microsoft_api_unavailableOuiLa recherche de compte grand public Microsoft était indisponible.
unitedinternet_api_errorOuiLa recherche de compte GMX.com / mail.com a échoué.
unitedinternet_api_unavailableNonLa recherche de compte GMX.com / mail.com était indisponible pour cette exécution.
capacity_deferredOuiLa capacité de vérification du fournisseur était saturée : le contrôle a été reporté.
provider_capacity_exhaustedNonLa 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_blockedNonDomaine d'opérateur japonais (docomo.ne.jp, au.com, etc.) — SMTP est bloqué par la politique de l'opérateur.
internal_verifier_errorOuiErreur interne non classifiée du vérificateur — défaillance transitoire.
rate_limitedOuiL'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_unknownNonLe 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_timeoutOuiLe 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.

RaisonDescription
catch_all_domainDomaine confirmé comme catch-all — sonde RCPT aléatoire acceptée par le serveur de messagerie.
catch_all_deliverableDomaine catch-all, et l'adresse précise a elle aussi renvoyé 250 OK sur RCPT.
catch_all_inferredStatut catch-all déduit d'éléments en cache (indirect, pas une sonde en direct).
m365_internal_relayDomaine Microsoft 365 configuré en relais interne — tous les RCPT sont acceptés mais non vérifiés individuellement.
gateway_accept_allLa passerelle de sécurité (Mimecast, Proofpoint, etc.) est en mode accept-all.
forwarding_aliasService d'alias de redirection d'email (SimpleLogin, Firefox Relay, Duck.com).
yahoo_isp_accept_allDomaine 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_allDomaine grand public régional connu pour accepter tout le courrier entrant (anciens résultats).
bucket_default_skip_smtp_catchallLe 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é.

RaisonDescription
disposable_domainLe 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_reasonsDescription
spamhaus_dbl_spamLe domaine est répertorié comme source de spam.
spamhaus_dbl_phishLe domaine est répertorié comme domaine d'hameçonnage.
spamhaus_dbl_malwareLe domaine est répertorié comme domaine de diffusion de logiciels malveillants.
spamhaus_dbl_botnet_ccLe 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);
}

On this page