BillionVerify LogoBillionVerify

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 catchall en niet als valid.
  • 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_*- of microsoft_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 unknown terug met smtp_unverifiable.

unknown-resultaten worden nooit in rekening gebracht, ongeacht de reden.

Valid (Geldig)

E-mails met status: "valid" zijn bevestigd afleverbaar.

RedenBeschrijving
smtp_deliverableSMTP RCPT gaf 250 OK terug — mailbox bevestigd afleverbaar. Ook het resultaat wanneer de DBEB-modus van Microsoft 365 de aflevering bevestigt.
yahoo_api_verifiedEen accountopzoeking bij Yahoo of AOL bevestigde dat het account bestaat.
microsoft_api_verifiedEen opzoeking van een Microsoft-consumentenaccount (Outlook.com, Hotmail, Live, MSN) bevestigde dat het account bestaat.
unitedinternet_api_verifiedEen 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.

RedenBeschrijving
invalid_syntaxHet e-mailadres faalt bij de syntaxisanalyse — ongeldig lokaal gedeelte of domein, of ontbrekende @. Wordt nooit in rekening gebracht.
no_mx_recordsHet domein heeft geen MX-records (NXDOMAIN of leeg MX-opzoekresultaat).
null_mxHet domein publiceert een null-MX-record (RFC 7505) — het accepteert uitdrukkelijk geen mail.
spf_reject_allHet domein heeft geen MX-records en een SPF-record met -all — het domein weigert uitdrukkelijk alle inkomende mail.
mailbox_not_foundSMTP 550/5xx bevestigde dat de mailbox niet bestaat op de externe server.
mailbox_disabledDe mailbox bestaat, maar is uitgeschakeld of gedeactiveerd.
host_not_foundDe MX-hostnaam reageerde niet — host onbereikbaar of niet-bestaand.
yahoo_api_not_deliverableEen accountopzoeking bij Yahoo of AOL bevestigde dat het account niet bestaat.
microsoft_api_not_deliverableEen opzoeking van een Microsoft-consumentenaccount bevestigde dat het account niet bestaat.
unitedinternet_api_not_deliverableEen 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.

RedenOpnieuw proberenBeschrijving
smtp_unverifiableNeeDe provider staat geen betrouwbare SMTP-verificatie toe (Apple iCloud, Proton, Tuta).
smtp_blockedNeeDe externe SMTP-server heeft de verbinding uitdrukkelijk geblokkeerd of op een zwarte lijst gezet.
smtp_eof_blockedJaDe MX sloot de verbinding voordat een banner werd verstuurd — meestal een snelheidsbegrenzer per IP of een fail2ban-regel.
smtp_timeoutJaSMTP-bewerking is verlopen (context-deadline of annulering).
smtp_connection_failedJaAlgemene SMTP-verbindingsfout — geen specifiekere klasse kwam overeen.
smtp_rate_limitedJaDe externe SMTP-server gaf een snelheidsbeperkingsantwoord terug (421, 450, 451 of berichtlimiet overschreden).
smtp_greylistedJaAlgemeen greylistingantwoord gedetecteerd — probeer het na een vertraging opnieuw.
smtp_550_unclassifiedJaDe server gaf een 550 terug die niet duidelijk betekent dat de gebruiker onbekend is, dus het adres wordt niet als ongeldig behandeld.
smtp_egress_unavailableJaOp het moment van de controle was er geen verificatie-uitgang beschikbaar voor deze provider.
smtp_egress_unselectableNeeGeen enkele verificatie-uitgang mag deze provider bereiken.
mimecast_greylistJaMimecast-specifieke greylisting / tijdelijke fout 451.
proofpoint_ad_lookupJaAsynchrone AD-opzoeking van Proofpoint loopt (421 4.1.1 tijdelijke fout tijdens ontvangersvalidatie).
proofpoint_egress_listedNeeDoor Proofpoint beschermd domein waar onze controles momenteel niet worden beantwoord.
policy_temp_failJaAlgemene tijdelijke 4xx-fout door beleidshandhaving op de externe server.
google_rate_limitJaGoogle MX gaf een snelheidsbeperking of tijdelijke weigering terug.
google_dmarc_misalignmentNeeDe DMARC-configuratie van het domein is niet uitgelijnd — Google weigert op basis van het DMARC-beleid.
m365_ip_rep_blockJaMicrosoft 365 weigerde de verbinding vanwege IP-reputatie (codes 4.7.650 / 4.7.651).
tonline_egress_not_whitelistedNeeT-Online accepteert alleen controles van afzenders op de toegestane lijst, dus de mailbox kan niet worden geverifieerd.
mailbox_fullNeeDe mailbox bestaat, maar zit over het quotum (SMTP 452 of antwoord dat de inbox vol is).
dns_timeoutJaDNS- of MX-opzoeking is verlopen — tijdelijk probleem met de resolver.
dns_lookup_errorJaDNS-opzoeking mislukte met een andere fout dan NXDOMAIN (SERVFAIL, UDP-time-out of resolverfout).
dns_resolution_failedJaDNS-resolutie mislukte om een tijdelijke reden.
yahoo_api_errorJaAccountopzoeking bij Yahoo / AOL mislukt — algemene fout.
yahoo_api_unavailableJaAccountopzoeking bij Yahoo / AOL was niet beschikbaar (storing op batchniveau).
yahoo_api_eofJaAccountopzoeking bij Yahoo / AOL gaf vroegtijdig EOF terug — tijdelijke TCP/TLS-verbreking.
yahoo_api_rate_limitedJaAccountopzoeking bij Yahoo / AOL werd snelheidsbegrensd.
microsoft_api_errorJaOpzoeking van een Microsoft-consumentenaccount mislukte of werd afgeremd.
microsoft_api_unavailableJaOpzoeking van een Microsoft-consumentenaccount was niet beschikbaar.
unitedinternet_api_errorJaAccountopzoeking bij GMX.com / mail.com mislukt.
unitedinternet_api_unavailableNeeAccountopzoeking bij GMX.com / mail.com was voor deze run niet beschikbaar.
capacity_deferredJaDe verificatiecapaciteit van de provider was vol, dus de controle is uitgesteld.
provider_capacity_exhaustedNeeDe capaciteit van de provider bleef het hele hervattingsvenster (ongeveer twee uur) vol, dus de taak werd voor deze adressen zonder conclusie afgerond.
carrier_blockedNeeJapans carrierdomein (docomo.ne.jp, au.com, enz.) — SMTP wordt geblokkeerd door het beleid van de carrier.
internal_verifier_errorJaNiet-geclassificeerde interne fout van de verificatie — tijdelijke storing.
rate_limitedJaE-mail werd snelheidsbegrensd tijdens batchverwerking (alias voor smtp_rate_limited in bestandstaken).
bucket_default_skip_smtp_unknownNeeDe verificatiemodus op accountniveau is ingesteld om SMTP over te slaan — het resultaat is alleen gebaseerd op domeincontroles.
mx_only_verification_semaphore_timeoutJaDe 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.

RedenBeschrijving
catch_all_domainDomein bevestigd als catch-all — de willekeurige RCPT-test werd door de mailserver geaccepteerd.
catch_all_deliverableCatch-all-domein, en het specifieke adres gaf op RCPT ook 250 OK terug.
catch_all_inferredCatch-all-status afgeleid uit gecachete aanwijzingen (indirect, geen live test).
m365_internal_relayMicrosoft 365-domein geconfigureerd als interne relay — alle RCPT's worden geaccepteerd, maar niet afzonderlijk geverifieerd.
gateway_accept_allBeveiligingsgateway (Mimecast, Proofpoint, enz.) staat in accept-all-modus.
forwarding_aliasDienst voor doorstuuralias (SimpleLogin, Firefox Relay, Duck.com).
yahoo_isp_accept_allISP-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_allRegionaal consumentendomein waarvan bekend is dat het alle inkomende mail accepteert (oudere resultaten).
bucket_default_skip_smtp_catchallDe 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.

RedenBeschrijving
disposable_domainHet 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_reasonsBeschrijving
spamhaus_dbl_spamHet domein staat vermeld als spambron.
spamhaus_dbl_phishHet domein staat vermeld als phishingdomein.
spamhaus_dbl_malwareHet domein staat vermeld als domein voor malwareverspreiding.
spamhaus_dbl_botnet_ccHet 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);
}

On this page