Verifizierungsgründe
Vollständige Referenz aller reason-Codes der BillionVerify API: was jeder Grund bedeutet und wie Sie darauf reagieren.
So funktioniert es
Wie funktioniert die E-Mail-Verifizierung? Schicht für Schicht
So funktioniert die E-Mail-Verifizierung, von der Syntax bis SMTP: Folgen Sie einer Adresse durch die neun Schichten, die ihr Ergebnis bestimmen. Sehen Sie, wo Adressen früh enden, wie die Antwort des Mailservers gelesen wird, wie Catch-all getestet wird und was jedes Ergebnis kostet.
Jedes Verifizierungsergebnis enthält ein reason-Feld, das erklärt, warum die E-Mail-Adresse ihren Status erhalten hat. Mit dieser Referenz bauen Sie präzise Filterregeln, klären unerwartete Ergebnisse und passen Ihre Versandstrategie an.
Funktionsweise der Gründe
Das reason-Feld steht in allen Verifizierungsantworten neben dem status-Feld:
{
"email": "user@example.com",
"status": "valid",
"reason": "smtp_deliverable"
}Gründe sind stabile String-Bezeichner — Sie können sie direkt in Filterregeln oder in nachgelagerter Bedingungslogik verwenden.
So wird jeder Postfachtyp verifiziert
Welchen Grund Sie erhalten, hängt davon ab, wie sich der Anbieter des Empfängers prüfen lässt:
- Geschäftliche Domains (Google Workspace, Microsoft 365, selbst betriebene Mailserver) erhalten eine Live-SMTP-RCPT-Prüfung für das exakte Postfach. Vorab wird eine zufällige Adresse auf derselben Domain geprüft. Catch-all-Domains, das interne Relay von Microsoft 365 und Sicherheits-Gateways im Accept-all-Modus werden deshalb als
catchallgemeldet statt alsvalid. - Gmail erhält eine Live-SMTP-RCPT-Prüfung.
- Yahoo, AOL, Outlook.com, Hotmail, Live und MSN blockieren die SMTP-Verifizierung und werden deshalb über anbieterspezifische Konto-Abfragen geprüft. Diese liefern
yahoo_api_*- odermicrosoft_api_*-Gründe und bestätigen, ob das Konto existiert. - GMX, web.de, Mail.ru, Yandex und andere regionale Anbieter werden mit anbieterspezifischem Tempolimit verifiziert. Ratenbegrenzungen, Greylisting und abgelehnte Prüfungen führen zu mehr
unknown-Ergebnissen. - Apple iCloud, Proton und Tuta erlauben keine verlässliche Prüfung, ihre Adressen liefern daher immer
unknownmitsmtp_unverifiable.
unknown-Ergebnisse werden nie berechnet, egal aus welchem Grund.
Valid (Gültig)
E-Mails mit status: "valid" sind als zustellbar bestätigt.
| Grund | Beschreibung |
|---|---|
smtp_deliverable | SMTP RCPT hat 250 OK zurückgegeben — Postfach als zustellbar bestätigt. Wird auch erzeugt, wenn der DBEB-Modus von Microsoft 365 die Zustellung bestätigt. |
yahoo_api_verified | Die Kontoabfrage bei Yahoo oder AOL hat bestätigt, dass das Konto existiert. |
microsoft_api_verified | Die Abfrage des Microsoft-Privatkontos (Outlook.com, Hotmail, Live, MSN) hat bestätigt, dass das Konto existiert. |
unitedinternet_api_verified | Die Kontoabfrage bei GMX.com / mail.com hat bestätigt, dass das Konto existiert. |
Invalid (Ungültig)
E-Mails mit status: "invalid" sollten Sie aus Ihrer Liste entfernen — eine Zustellung ist nicht möglich.
| Grund | Beschreibung |
|---|---|
invalid_syntax | Die E-Mail-Adresse besteht die Syntaxprüfung nicht — fehlerhafter lokaler Teil, fehlerhafte Domain oder fehlendes @. Wird nie berechnet. |
no_mx_records | Die Domain hat keine MX-Einträge (NXDOMAIN oder leeres Ergebnis der MX-Abfrage). |
null_mx | Die Domain veröffentlicht einen Null-MX-Eintrag (RFC 7505) — sie nimmt ausdrücklich keine E-Mails an. |
spf_reject_all | Die Domain hat keine MX-Einträge und einen SPF-Eintrag mit -all — die Domain lehnt ausdrücklich alle eingehenden E-Mails ab. |
mailbox_not_found | SMTP 550/5xx hat bestätigt, dass das Postfach auf dem Remote-Server nicht existiert. |
mailbox_disabled | Das Postfach existiert, wurde aber deaktiviert. |
host_not_found | Der MX-Hostname hat nicht geantwortet — Host nicht erreichbar oder nicht vorhanden. |
yahoo_api_not_deliverable | Die Kontoabfrage bei Yahoo oder AOL hat bestätigt, dass das Konto nicht existiert. |
microsoft_api_not_deliverable | Die Abfrage des Microsoft-Privatkontos hat bestätigt, dass das Konto nicht existiert. |
unitedinternet_api_not_deliverable | Die Kontoabfrage bei GMX.com / mail.com hat bestätigt, dass das Konto nicht existiert. |
Unknown (Unbekannt)
E-Mails mit status: "unknown" ließen sich nicht abschließend verifizieren. Unbekannte Ergebnisse werden nie berechnet. Manche sind vorübergehend (wiederholbar), andere beruhen auf strukturellen Einschränkungen.
| Grund | Wiederholbar | Beschreibung |
|---|---|---|
smtp_unverifiable | Nein | Der Anbieter erlaubt keine verlässliche SMTP-Verifizierung (Apple iCloud, Proton, Tuta). |
smtp_blocked | Nein | Der Remote-SMTP-Server hat die Verbindung ausdrücklich blockiert oder gesperrt. |
smtp_eof_blocked | Ja | Der MX hat die Verbindung geschlossen, bevor er ein Banner gesendet hat — typischerweise eine Ratenbegrenzung pro IP oder eine fail2ban-Regel. |
smtp_timeout | Ja | Zeitüberschreitung bei der SMTP-Operation (Kontext-Deadline oder Abbruch). |
smtp_connection_failed | Ja | Allgemeiner SMTP-Verbindungsfehler — keine spezifischere Klasse passt. |
smtp_rate_limited | Ja | Der Remote-SMTP-Server hat eine Ratenbegrenzung gemeldet (421, 450, 451 oder Versandlimit überschritten). |
smtp_greylisted | Ja | Allgemeine Greylisting-Antwort erkannt — Versuch nach einer Wartezeit wiederholen. |
smtp_550_unclassified | Ja | Der Server hat ein 550 zurückgegeben, das nicht eindeutig „Benutzer unbekannt“ bedeutet, und wird daher nicht als ungültig gewertet. |
smtp_egress_unavailable | Ja | Zum Zeitpunkt der Prüfung stand für diesen Anbieter kein Verifizierungs-Egress zur Verfügung. |
smtp_egress_unselectable | Nein | Kein Verifizierungs-Egress darf diesen Anbieter erreichen. |
mimecast_greylist | Ja | Mimecast-spezifisches Greylisting / vorübergehender Fehler 451. |
proofpoint_ad_lookup | Ja | Asynchrone Proofpoint-AD-Abfrage läuft (vorübergehender Fehler 421 4.1.1 bei der Empfängerprüfung). |
proofpoint_egress_listed | Nein | Durch Proofpoint geschützte Domain, die unsere Prüfungen derzeit nicht beantwortet. |
policy_temp_fail | Ja | Allgemeiner vorübergehender 4xx-Fehler durch die Richtlinien des Remote-Servers. |
google_rate_limit | Ja | Der Google-MX hat eine Ratenbegrenzung oder eine vorübergehende Ablehnung gemeldet. |
google_dmarc_misalignment | Nein | Die DMARC-Konfiguration der Domain ist nicht ausgerichtet — Google lehnt auf Grundlage der DMARC-Richtlinie ab. |
m365_ip_rep_block | Ja | Microsoft 365 hat die Verbindung wegen der IP-Reputation abgelehnt (Codes 4.7.650 / 4.7.651). |
tonline_egress_not_whitelisted | Nein | T-Online akzeptiert Prüfungen nur von freigegebenen Absendern, das Postfach lässt sich daher nicht verifizieren. |
mailbox_full | Nein | Das Postfach existiert, hat aber sein Speicherlimit überschritten (SMTP 452 oder Antwort „Postfach voll“). |
dns_timeout | Ja | Zeitüberschreitung bei der DNS- oder MX-Abfrage — vorübergehendes Resolver-Problem. |
dns_lookup_error | Ja | Die DNS-Abfrage ist mit einem Fehler außer NXDOMAIN fehlgeschlagen (SERVFAIL, UDP-Timeout oder Resolver-Fehler). |
dns_resolution_failed | Ja | Die DNS-Auflösung ist aus einem vorübergehenden Grund fehlgeschlagen. |
yahoo_api_error | Ja | Die Kontoabfrage bei Yahoo / AOL ist fehlgeschlagen — allgemeiner Fehler. |
yahoo_api_unavailable | Ja | Die Kontoabfrage bei Yahoo / AOL war nicht verfügbar (Ausfall auf Batch-Ebene). |
yahoo_api_eof | Ja | Die Kontoabfrage bei Yahoo / AOL hat ein vorzeitiges EOF geliefert — vorübergehender TCP/TLS-Abbruch. |
yahoo_api_rate_limited | Ja | Die Kontoabfrage bei Yahoo / AOL wurde durch eine Ratenbegrenzung gebremst. |
microsoft_api_error | Ja | Die Abfrage des Microsoft-Privatkontos ist fehlgeschlagen oder wurde gedrosselt. |
microsoft_api_unavailable | Ja | Die Abfrage des Microsoft-Privatkontos war nicht verfügbar. |
unitedinternet_api_error | Ja | Die Kontoabfrage bei GMX.com / mail.com ist fehlgeschlagen. |
unitedinternet_api_unavailable | Nein | Die Kontoabfrage bei GMX.com / mail.com war für diesen Lauf nicht verfügbar. |
capacity_deferred | Ja | Die Verifizierungskapazität des Anbieters war ausgelastet, die Prüfung wurde daher zurückgestellt. |
provider_capacity_exhausted | Nein | Die Kapazität des Anbieters blieb während des gesamten Wiederholungsfensters (etwa zwei Stunden) ausgelastet, der Auftrag endete für diese Adressen daher ohne Ergebnis. |
carrier_blocked | Nein | Domain eines japanischen Mobilfunkanbieters (docomo.ne.jp, au.com usw.) — SMTP ist durch die Richtlinie des Anbieters blockiert. |
internal_verifier_error | Ja | Nicht klassifizierter interner Fehler des Verifizierers — vorübergehender Ausfall. |
rate_limited | Ja | Die E-Mail wurde bei der Batch-Verarbeitung durch eine Ratenbegrenzung gebremst (Alias für smtp_rate_limited in Dateiaufträgen). |
bucket_default_skip_smtp_unknown | Nein | Der Verifizierungsmodus des Kontos ist auf „SMTP überspringen“ gesetzt — das Ergebnis beruht nur auf Domain-Prüfungen. |
mx_only_verification_semaphore_timeout | Ja | Zeitüberschreitung beim SMTP-Parallelitäts-Semaphor — der MX-only-Fallback hat gültige MX-Einträge bestätigt, das Postfach ließ sich aber nicht einzeln verifizieren. |
Catch-all
E-Mails mit status: "catchall" gehören zu Domains, die E-Mails für alle Adressen annehmen. Die Zustellbarkeit einzelner Adressen lässt sich nicht bestätigen.
| Grund | Beschreibung |
|---|---|
catch_all_domain | Domain als Catch-all bestätigt — die zufällige RCPT-Probe wurde vom Mailserver akzeptiert. |
catch_all_deliverable | Catch-all-Domain, und auch die konkrete Adresse hat bei RCPT 250 OK zurückgegeben. |
catch_all_inferred | Catch-all-Status aus zwischengespeicherten Belegen abgeleitet (indirekt, keine Live-Probe). |
m365_internal_relay | Microsoft-365-Domain als internes Relay konfiguriert — alle RCPT werden akzeptiert, aber nicht einzeln verifiziert. |
gateway_accept_all | Sicherheits-Gateway (Mimecast, Proofpoint usw.) im Accept-all-Modus. |
forwarding_alias | Dienst für E-Mail-Weiterleitungs-Aliasse (SimpleLogin, Firefox Relay, Duck.com). |
yahoo_isp_accept_all | Provider-Domain auf der Yahoo-Mail-Infrastruktur (zum Beispiel att.net, sbcglobal.net, verizon.net) — der Anbieter akzeptiert alle Empfänger, eine Prüfung auf Postfachebene ist daher nicht möglich. |
region_consumer_accept_all | Regionale Privatkunden-Domain, die bekanntermaßen alle eingehenden E-Mails annimmt (ältere Ergebnisse). |
bucket_default_skip_smtp_catchall | Der Verifizierungsmodus des Kontos ist auf „SMTP-Catch-all-Erkennung überspringen“ gesetzt. |
Role (Rollenadresse)
E-Mails mit status: "role" gehören zu gemeinsamen Postfächern (z. B. info@, support@, noreply@). Diese Adressen sind in der Regel zustellbar, erzielen aber nur geringes Engagement.
Rollenadressen übernehmen den reason aus ihrer zugrunde liegenden SMTP-Prüfung — für diesen Status gibt es keine eigenen Grund-Codes. Eine Rollenadresse, die die SMTP-Prüfung besteht, zeigt zum Beispiel reason: "smtp_deliverable".
Disposable (Wegwerfadresse)
E-Mails mit status: "disposable" gehören zu temporären E-Mail-Diensten. Wer solche Adressen akzeptiert, erhält meist Anmeldungen von geringer Qualität.
| Grund | Beschreibung |
|---|---|
disposable_domain | Die Domain ist als bekannter Anbieter von Wegwerf- bzw. temporären E-Mail-Adressen gelistet. |
Risky (nur ältere Ergebnisse)
Neue Verifizierungen liefern status: "risky" nicht mehr. Die einzige Quelle dafür, die Spamhaus-Domain-Blocklist-Prüfung, wurde am 2026-09-11 entfernt. Bei Ergebnissen, die vor diesem Datum entstanden sind, sehen Sie risky möglicherweise weiterhin.
Bei diesen älteren Ergebnissen bedeutete risky, dass die Adresse höchstwahrscheinlich zustellbar war, die Empfängerdomain aber von Spamhaus wegen Spam, Phishing, Malware oder Botnet-C&C-Aktivität gelistet wurde. Das Array risk_reasons nennt den Grund:
Wert in risk_reasons | Beschreibung |
|---|---|
spamhaus_dbl_spam | Die Domain ist als Spam-Quelle gelistet. |
spamhaus_dbl_phish | Die Domain ist als Phishing-Domain gelistet. |
spamhaus_dbl_malware | Die Domain ist als Domain zur Malware-Verbreitung gelistet. |
spamhaus_dbl_botnet_cc | Die Domain ist als Botnet-Command-and-Control-Infrastruktur gelistet. |
Gründe beim Filtern verwenden
Sie können status und reason kombinieren, um Listen präzise zu segmentieren. Zum Beispiel, um unknown-E-Mails zu behalten, die nur wegen vorübergehender Probleme unbekannt sind:
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);
}