Verificatieredenen
Volledige referentie van alle redencodes die de e-mailverificatie van de BillionVerify API teruggeeft — wat elke reden betekent en hoe u ermee omgaat.
Zie hoe het werkt
Hoe werkt e-mailverificatie? Laag voor laag
Hoe e-mailverificatie werkt, van syntaxis tot SMTP: volg een adres door de negen lagen die het resultaat bepalen. Zie waar adressen vroeg stoppen, hoe het antwoord van de mailserver wordt gelezen, hoe catch-all wordt getest en wat elk resultaat kost.
Elk verificatieresultaat bevat een reason-veld dat uitlegt waarom het e-mailadres zijn status heeft gekregen. Gebruik deze referentie om nauwkeurige filterlogica te bouwen, onverwachte resultaten te onderzoeken en uw verzendstrategie af te stemmen.
Hoe redenen werken
Het reason-veld staat in alle verificatieresponses naast het status-veld:
{
"email": "user@example.com",
"status": "valid",
"reason": "smtp_deliverable"
}Redenen zijn stabiele tekenreeksen als identificatie — u kunt ze direct gebruiken in filterregels of in latere voorwaardelijke logica.
Hoe elk type mailbox wordt geverifieerd
De reden die u krijgt, hangt af van hoe de provider van de ontvanger kan worden gecontroleerd:
- Zakelijke domeinen (Google Workspace, Microsoft 365, zelf gehoste mailservers) krijgen een live SMTP RCPT-controle op precies die mailbox. Eerst wordt een willekeurig adres op hetzelfde domein getest, zodat catch-all-domeinen, de interne relay van Microsoft 365 en beveiligingsgateways in accept-all-modus worden gemeld als
catchallen niet alsvalid. - Gmail krijgt een live SMTP RCPT-controle.
- Yahoo, AOL, Outlook.com, Hotmail, Live en MSN blokkeren SMTP-verificatie, dus ze worden gecontroleerd via providerspecifieke accountopzoekingen. Die geven
yahoo_api_*- ofmicrosoft_api_*-redenen terug en bevestigen of het account bestaat. - GMX, web.de, Mail.ru, Yandex en andere regionale providers worden geverifieerd met providerspecifieke temporegels. Snelheidslimieten, greylisting en geweigerde controles leiden tot meer
unknown-resultaten. - Apple iCloud, Proton en Tuta staan geen betrouwbare controle toe, dus hun adressen geven altijd
unknownterug metsmtp_unverifiable.
unknown-resultaten worden nooit in rekening gebracht, ongeacht de reden.
Valid (Geldig)
E-mails met status: "valid" zijn bevestigd afleverbaar.
| Reden | Beschrijving |
|---|---|
smtp_deliverable | SMTP RCPT gaf 250 OK terug — mailbox bevestigd afleverbaar. Ook het resultaat wanneer de DBEB-modus van Microsoft 365 de aflevering bevestigt. |
yahoo_api_verified | Een accountopzoeking bij Yahoo of AOL bevestigde dat het account bestaat. |
microsoft_api_verified | Een opzoeking van een Microsoft-consumentenaccount (Outlook.com, Hotmail, Live, MSN) bevestigde dat het account bestaat. |
unitedinternet_api_verified | Een accountopzoeking bij GMX.com / mail.com bevestigde dat het account bestaat. |
Invalid (Ongeldig)
E-mails met status: "invalid" moeten van uw lijst worden verwijderd — aflevering is niet mogelijk.
| Reden | Beschrijving |
|---|---|
invalid_syntax | Het e-mailadres faalt bij de syntaxisanalyse — ongeldig lokaal gedeelte of domein, of ontbrekende @. Wordt nooit in rekening gebracht. |
no_mx_records | Het domein heeft geen MX-records (NXDOMAIN of leeg MX-opzoekresultaat). |
null_mx | Het domein publiceert een null-MX-record (RFC 7505) — het accepteert uitdrukkelijk geen mail. |
spf_reject_all | Het domein heeft geen MX-records en een SPF-record met -all — het domein weigert uitdrukkelijk alle inkomende mail. |
mailbox_not_found | SMTP 550/5xx bevestigde dat de mailbox niet bestaat op de externe server. |
mailbox_disabled | De mailbox bestaat, maar is uitgeschakeld of gedeactiveerd. |
host_not_found | De MX-hostnaam reageerde niet — host onbereikbaar of niet-bestaand. |
yahoo_api_not_deliverable | Een accountopzoeking bij Yahoo of AOL bevestigde dat het account niet bestaat. |
microsoft_api_not_deliverable | Een opzoeking van een Microsoft-consumentenaccount bevestigde dat het account niet bestaat. |
unitedinternet_api_not_deliverable | Een accountopzoeking bij GMX.com / mail.com bevestigde dat het account niet bestaat. |
Unknown (Onbekend)
E-mails met status: "unknown" konden niet sluitend worden geverifieerd. Onbekende resultaten worden nooit in rekening gebracht. Sommige zijn tijdelijk (opnieuw te proberen), andere duiden op structurele beperkingen.
| Reden | Opnieuw proberen | Beschrijving |
|---|---|---|
smtp_unverifiable | Nee | De provider staat geen betrouwbare SMTP-verificatie toe (Apple iCloud, Proton, Tuta). |
smtp_blocked | Nee | De externe SMTP-server heeft de verbinding uitdrukkelijk geblokkeerd of op een zwarte lijst gezet. |
smtp_eof_blocked | Ja | De MX sloot de verbinding voordat een banner werd verstuurd — meestal een snelheidsbegrenzer per IP of een fail2ban-regel. |
smtp_timeout | Ja | SMTP-bewerking is verlopen (context-deadline of annulering). |
smtp_connection_failed | Ja | Algemene SMTP-verbindingsfout — geen specifiekere klasse kwam overeen. |
smtp_rate_limited | Ja | De externe SMTP-server gaf een snelheidsbeperkingsantwoord terug (421, 450, 451 of berichtlimiet overschreden). |
smtp_greylisted | Ja | Algemeen greylistingantwoord gedetecteerd — probeer het na een vertraging opnieuw. |
smtp_550_unclassified | Ja | De server gaf een 550 terug die niet duidelijk betekent dat de gebruiker onbekend is, dus het adres wordt niet als ongeldig behandeld. |
smtp_egress_unavailable | Ja | Op het moment van de controle was er geen verificatie-uitgang beschikbaar voor deze provider. |
smtp_egress_unselectable | Nee | Geen enkele verificatie-uitgang mag deze provider bereiken. |
mimecast_greylist | Ja | Mimecast-specifieke greylisting / tijdelijke fout 451. |
proofpoint_ad_lookup | Ja | Asynchrone AD-opzoeking van Proofpoint loopt (421 4.1.1 tijdelijke fout tijdens ontvangersvalidatie). |
proofpoint_egress_listed | Nee | Door Proofpoint beschermd domein waar onze controles momenteel niet worden beantwoord. |
policy_temp_fail | Ja | Algemene tijdelijke 4xx-fout door beleidshandhaving op de externe server. |
google_rate_limit | Ja | Google MX gaf een snelheidsbeperking of tijdelijke weigering terug. |
google_dmarc_misalignment | Nee | De DMARC-configuratie van het domein is niet uitgelijnd — Google weigert op basis van het DMARC-beleid. |
m365_ip_rep_block | Ja | Microsoft 365 weigerde de verbinding vanwege IP-reputatie (codes 4.7.650 / 4.7.651). |
tonline_egress_not_whitelisted | Nee | T-Online accepteert alleen controles van afzenders op de toegestane lijst, dus de mailbox kan niet worden geverifieerd. |
mailbox_full | Nee | De mailbox bestaat, maar zit over het quotum (SMTP 452 of antwoord dat de inbox vol is). |
dns_timeout | Ja | DNS- of MX-opzoeking is verlopen — tijdelijk probleem met de resolver. |
dns_lookup_error | Ja | DNS-opzoeking mislukte met een andere fout dan NXDOMAIN (SERVFAIL, UDP-time-out of resolverfout). |
dns_resolution_failed | Ja | DNS-resolutie mislukte om een tijdelijke reden. |
yahoo_api_error | Ja | Accountopzoeking bij Yahoo / AOL mislukt — algemene fout. |
yahoo_api_unavailable | Ja | Accountopzoeking bij Yahoo / AOL was niet beschikbaar (storing op batchniveau). |
yahoo_api_eof | Ja | Accountopzoeking bij Yahoo / AOL gaf vroegtijdig EOF terug — tijdelijke TCP/TLS-verbreking. |
yahoo_api_rate_limited | Ja | Accountopzoeking bij Yahoo / AOL werd snelheidsbegrensd. |
microsoft_api_error | Ja | Opzoeking van een Microsoft-consumentenaccount mislukte of werd afgeremd. |
microsoft_api_unavailable | Ja | Opzoeking van een Microsoft-consumentenaccount was niet beschikbaar. |
unitedinternet_api_error | Ja | Accountopzoeking bij GMX.com / mail.com mislukt. |
unitedinternet_api_unavailable | Nee | Accountopzoeking bij GMX.com / mail.com was voor deze run niet beschikbaar. |
capacity_deferred | Ja | De verificatiecapaciteit van de provider was vol, dus de controle is uitgesteld. |
provider_capacity_exhausted | Nee | De capaciteit van de provider bleef het hele hervattingsvenster (ongeveer twee uur) vol, dus de taak werd voor deze adressen zonder conclusie afgerond. |
carrier_blocked | Nee | Japans carrierdomein (docomo.ne.jp, au.com, enz.) — SMTP wordt geblokkeerd door het beleid van de carrier. |
internal_verifier_error | Ja | Niet-geclassificeerde interne fout van de verificatie — tijdelijke storing. |
rate_limited | Ja | E-mail werd snelheidsbegrensd tijdens batchverwerking (alias voor smtp_rate_limited in bestandstaken). |
bucket_default_skip_smtp_unknown | Nee | De verificatiemodus op accountniveau is ingesteld om SMTP over te slaan — het resultaat is alleen gebaseerd op domeincontroles. |
mx_only_verification_semaphore_timeout | Ja | De SMTP-gelijktijdigheidssemafoor is verlopen — de MX-only-terugval bevestigde geldige MX-records, maar de mailbox kon niet afzonderlijk worden geverifieerd. |
Catch-all
E-mails met status: "catchall" horen bij domeinen die mail voor alle adressen accepteren. De afleverbaarheid van een afzonderlijk adres kan niet worden bevestigd.
| Reden | Beschrijving |
|---|---|
catch_all_domain | Domein bevestigd als catch-all — de willekeurige RCPT-test werd door de mailserver geaccepteerd. |
catch_all_deliverable | Catch-all-domein, en het specifieke adres gaf op RCPT ook 250 OK terug. |
catch_all_inferred | Catch-all-status afgeleid uit gecachete aanwijzingen (indirect, geen live test). |
m365_internal_relay | Microsoft 365-domein geconfigureerd als interne relay — alle RCPT's worden geaccepteerd, maar niet afzonderlijk geverifieerd. |
gateway_accept_all | Beveiligingsgateway (Mimecast, Proofpoint, enz.) staat in accept-all-modus. |
forwarding_alias | Dienst voor doorstuuralias (SimpleLogin, Firefox Relay, Duck.com). |
yahoo_isp_accept_all | ISP-domein dat op de mailinfrastructuur van Yahoo draait (bijvoorbeeld att.net, sbcglobal.net, verizon.net) — de provider accepteert alle ontvangers, dus een controle op mailboxniveau is niet mogelijk. |
region_consumer_accept_all | Regionaal consumentendomein waarvan bekend is dat het alle inkomende mail accepteert (oudere resultaten). |
bucket_default_skip_smtp_catchall | De verificatiemodus op accountniveau is ingesteld om SMTP-catch-all-detectie over te slaan. |
Role (Rol)
E-mails met status: "role" horen bij gedeelde inboxen (bijvoorbeeld info@, support@, noreply@). Deze adressen zijn doorgaans afleverbaar, maar hebben een lage betrokkenheid.
Roladressen nemen de reason over van hun onderliggende SMTP-controle — voor deze status bestaan geen eigen redencodes. Een roladres dat de SMTP-controle doorstaat, toont bijvoorbeeld reason: "smtp_deliverable".
Disposable (Wegwerp)
E-mails met status: "disposable" horen bij tijdelijke e-maildiensten. Het accepteren ervan leidt meestal tot aanmeldingen van lage kwaliteit.
| Reden | Beschrijving |
|---|---|
disposable_domain | Het domein staat vermeld als bekende aanbieder van wegwerp- of tijdelijke e-mail. |
Risky (alleen oudere resultaten)
Nieuwe verificaties geven status: "risky" niet meer terug. De enige bron ervan, de controle op de Spamhaus Domain Blocklist, is op 2026-09-11 verwijderd. Op resultaten die vóór die datum zijn aangemaakt, kunt u risky nog steeds zien.
Bij die oudere resultaten betekende risky dat het adres vrijwel zeker afleverbaar was, maar dat het domein van de ontvanger door Spamhaus werd vermeld wegens spam, phishing, malware of botnet-C&C-activiteit. De array risk_reasons legt uit waarom:
Waarde in risk_reasons | Beschrijving |
|---|---|
spamhaus_dbl_spam | Het domein staat vermeld als spambron. |
spamhaus_dbl_phish | Het domein staat vermeld als phishingdomein. |
spamhaus_dbl_malware | Het domein staat vermeld als domein voor malwareverspreiding. |
spamhaus_dbl_botnet_cc | Het domein staat vermeld als botnet-commandoinfrastructuur (C&C). |
Redenen gebruiken bij het filteren
U kunt status en reason combineren voor een nauwkeurige segmentatie van uw lijst. Zo behoudt u bijvoorbeeld unknown-e-mails die alleen onbekend zijn door tijdelijke problemen:
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);
}