Zum Inhalt springen
Doku

E-Mail-Verifizierung

Eine einzelne Adresse in Echtzeit verifizieren.

Basis-URLhttps://api.emailit.com/v2AuthentifizierungFehlerRate Limits

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.

POST/email-verifications

Anfrage-Body

emailstringErforderlich

Zu 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.

modestring

fast (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

statusstring

completed bei Einzelverifizierungen.

checksobject

Einzelne 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).

addressobject

Die Adresse, aufgeteilt in mailbox, domain, suffix (der Teil nach + oder null) und root (die Adresse ohne Suffix).

did_you_meanstring | null

Korrekturvorschlag 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.

POST/email-verifications
Terminal
curl -X POST https://api.emailit.com/v2/email-verifications \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "ada@example.com"}'
JSON
{
  "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"
}

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.