E-Mail-Verifizierung
Eine einzelne Adresse in Echtzeit verifizieren.
Adresse verifizieren
Verifiziert eine E-Mail-Adresse und gibt das Ergebnis in der Antwort zurück. Jede Verifizierung kostet 5 Credits, die vor der Prüfung berechnet werden. Um viele Adressen auf einmal zu verifizieren, erstellen Sie eine Verifizierungsliste. Erfordert einen API-Schlüssel mit dem Scope full.
/email-verificationsAnfrage-Body
emailstringErforderlichZu verifizierende Adresse. Ein Wert, der keine gültige Adresse ist, gibt trotzdem 200 zurück, mit result: "invalid" und einem Score von 0, und wird berechnet.
modestringfast (Standard) prüft Syntax, Wegwerf- und Rollenadressen, Freemail-Anbieter, sinnlose Zeichenfolgen, MX-Einträge und das Alter der Domain. full verbindet sich zusätzlich mit dem Mailserver des Empfängers, um zu prüfen, ob das Postfach existiert, deaktiviert oder voll ist und ob die Domain alle Adressen annimmt. Nur der Modus full kann ein Postfach bestätigen. Im Modus fast sind die Postfachprüfungen null. full kann bis zu etwa 40 Sekunden dauern, wenn ein Mailserver langsam ist. Setzen Sie das Timeout Ihres Clients daher höher an.
Rückgabe
Gibt 200 OK mit einem Objekt email_verification zurück. Emailit sendet außerdem das Webhook-Event email_verification.created.
| Status | Wann |
|---|---|
400 |
email fehlt oder mode ist nicht fast oder full (Standard-Validierungsfehler). |
402 |
Im Workspace sind keine 5 Credits mehr übrig. Der Body ist {"error": {"message": "…", "code": 402}}. |
Ergebnis
result |
Bedeutung |
|---|---|
safe |
full: Der Mailserver hat das Postfach angenommen und eine erfundene Adresse auf derselben Domain abgelehnt. fast: Keine Prüfung ist fehlgeschlagen und der Score ist 70 oder höher; das Postfach wurde nicht geprüft. |
role |
Eine Rollenadresse wie info@ oder support@. Im Modus full wurde außerdem das Postfach bestätigt. |
catch_all |
Die Domain nimmt E-Mails für jede Adresse an, daher lässt sich das Postfach nicht bestätigen. Nur im Modus full. |
unknown |
Keine eindeutige Antwort: Der Mailserver hat die Prüfung blockiert oder zurückgestellt oder nicht geantwortet, oder der DNS-Lookup ist fehlgeschlagen. Im Modus fast außerdem, wenn keine Prüfung fehlgeschlagen ist, der Score aber unter 70 liegt. |
inbox_full |
Das Postfach ist voll. Nur im Modus full. |
disabled |
Das Postfach existiert, ist aber deaktiviert. Nur im Modus full. |
disposable |
Die Domain gehört zu einem Wegwerf-E-Mail-Dienst. |
invalid |
Die Syntax ist ungültig, die Domain hat keine MX-Einträge, oder der Mailserver hat gemeldet, dass das Postfach nicht existiert. |
In welcher Reihenfolge Emailit sie anwendet, steht unter Verifizierungsergebnisse.
Score und Risiko
score reicht von 0 bis 100; Adressen, die keine E-Mails empfangen können, erhalten 0. risk ist high bei invalid, disabled und disposable und medium bei catch_all, inbox_full und unknown (high, wenn ihr Score unter 50 liegt). Bei safe und role richtet sich der Wert nach dem Score: low ab 80, medium ab 50 und high unter 50. Siehe Score.
Felder
statusstringcompleted bei Einzelverifizierungen.
checksobjectEinzelne Prüfungen: valid_syntax, disposable, role_account, free_email und gibberish (Booleans), has_mx_records (Boolean oder null, wenn der DNS-Lookup fehlgeschlagen ist), domain_age (Alter der Domain in Tagen oder null, wenn unbekannt) sowie die Prüfungen des Modus full: smtp_connect, deliverable, disabled, inbox_full und catch_all (null im Modus fast und im Modus full, wenn der Mailserver keine eindeutige Antwort gegeben hat).
addressobjectDie Adresse, aufgeteilt in mailbox, domain, suffix (der Teil nach + oder null) und root (die Adresse ohne Suffix).
did_you_meanstring | nullKorrekturvorschlag für einen wahrscheinlichen Tippfehler, zum Beispiel ada@gmail.com für ada@gmial.com.
mx_recordsobject[]Die MX-Einträge der Domain, jeweils mit priority und exchange.
{
"id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "fast",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": null,
"deliverable": null,
"disabled": null,
"catch_all": null,
"free_email": false,
"smtp_connect": null,
"has_mx_records": true,
"domain_age": 10957,
"gibberish": false
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{ "priority": 10, "exchange": "mx1.example.com" }
],
"created_at": "2026-10-01T10:20:31.118000+00:00",
"updated_at": "2026-10-01T10:20:31.118000+00:00"
}{
"error": {
"message": "Workspace has insufficient email credits for email verification. Each verification requires 5 credits.",
"code": 402
}
}