API-Dokumente zur E-Mail-Validierung

Erste Schritte

Alle API-Anfragen erfordern eine Authentifizierung mit einem API-Schlüssel. Sie können Ihren API-Schlüssel im Dashboard finden.

Kopfzeile: "x-api-key: your-api-key"

Einzelne Verifizierung

Überprüfen Sie eine einzelne E-Mail-Adresse oder Domäne auf Gültigkeit, Wegwerfstatus, Datenschutzdienste und Zustellbarkeit.

Endpunkt

GET /v1/verify

Parameter

Name	Typ	Erforderlich	Beschreibung
input	string	Ja	Zu überprüfende E-Mail-Adresse oder Domäne (z. B. test@example.com oder example.com)

Antwortfelder

Feld	Beschreibung
valid	Zeigt an, ob das E-Mail-Format korrekt ist
block	Gibt an, ob die E-Mail blockiert werden soll (true, wenn disposable, privacy, applePrivateEmail, deliverable oder catch_all true ist)
disposable	Bestimmt, ob die E-Mail-Adresse eine temporäre oder eine Wegwerf-E-Mail-Adresse ist
privacy	Ermittelt, ob der Mailserver einen E-Mail-Alias oder Forwarder verwendet
applePrivateEmail	Zeigt an, ob es sich bei der E-Mail um eine private Apple-E-Mail-Adresse handelt.
deliverable	Prüft, ob die Mailbox existiert und E-Mails empfangen kann
domain	Der Domänenteil der E-Mail Adresse
email_address	Die E-Mail Adresse
catch_all	Zeigt an, ob die Domäne eine Catch-All-E-Mail-Konfiguration hat, die alle eingehenden E-Mails unabhängig von der Empfängeradresse annimmt
mx_found	Zeigt an, ob die Domäne über gültige Mailserver (MX-Einträge) verfügt.
remaining_credits	Die Anzahl der verbleibenden API-Guthaben auf Ihrem Konto

Schwarze Liste/Whitelist: Nur das Feld "Block" spiegelt die Zugehörigkeit zur Liste wider. Schwarze Liste → blockieren: wahr; Weiße Liste → blockieren: falsch; nicht in der Weißen Liste (wenn aktiviert) → blockieren: wahr. Verwenden Sie nicht "valid", um anhand von Listen zu entscheiden, ob gesperrt werden soll.

Beispiel Antwort

{
  "valid": true,
  "block": false,
  "disposable": false,
  "privacy": false,
  "applePrivateEmail": false,
  "deliverable": true,
  "domain": "example.com",
  "email_address": "test@example.com",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Code-Beispiele

curl "https://api.verify-email.app/v1/verify?input=test@example.com" \
  -H "X-API-Key: your-api-key"

Probieren Sie es aus

API-Schlüssel

Sie benötigen einen API-Schlüssel, um die Endpunkte zu testen.

E-Mail-Adresse oder Domain

Versuchen Sie es mit:

Chargenverifizierung

Überprüfen Sie mehrere E-Mail-Adressen oder Domänen in einer einzigen Anfrage (maximal 100 Einträge).

Endpunkt

POST /v1/verify/batch

Parameter

Name	Typ	Erforderlich	Beschreibung
inputs	array of strings	Ja	Eine Reihe von zu überprüfenden E-Mail-Adressen oder Domänen

Code-Beispiele

curl -X POST "https://api.verify-email.app/v1/verify/batch" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "inputs": [
      "test1@example.com",
      "test2@example.com"
    ]
  }'

Probieren Sie es aus

API-Schlüssel

Sie benötigen einen API-Schlüssel, um die Endpunkte zu testen.

E-Mail-Adressen oder Domains

Versuchen Sie es mit verschiedenen Domains:

Nur-lieferbar-Prüfung

Schnelle Überprüfung der E-Mail-Zustellbarkeit mit MX- und SMTP-Verifizierung ohne externe API-Aufrufe. Gibt nur zustellungsrelevante Felder für schnellere Antwortzeiten zurück.

Endpunkt

GET /v1/verify/deliverable

Parameter

Name	Typ	Erforderlich	Beschreibung
input	string	Ja	E-Mail-Adresse zur Überprüfung der Zustellbarkeit (z. B. test@example.com). Eingaben, die nur die Domäne betreffen, werden für diesen Endpunkt nicht unterstützt.

Antwortfelder

Feld	Beschreibung
valid	Zeigt an, ob das E-Mail-Format korrekt ist
deliverable	Prüft, ob die Mailbox existiert und E-Mails empfangen kann
mx_found	Zeigt an, ob die Domäne über gültige Mailserver (MX-Einträge) verfügt.
catch_all	Zeigt an, ob die Domäne eine Catch-All-E-Mail-Konfiguration hat, die alle eingehenden E-Mails unabhängig von der Empfängeradresse annimmt
email_address	Die E-Mail Adresse
remaining_credits	Die Anzahl der verbleibenden API-Guthaben auf Ihrem Konto

Beispiel Antwort

{
  "valid": true,
  "deliverable": true,
  "mx_found": true,
  "catch_all": false,
  "email_address": "test@example.com",
  "remaining_credits": 99
}

Code-Beispiele

curl "https://api.verify-email.app/v1/verify/deliverable?input=test@example.com" \
  -H "X-API-Key: your-api-key"

Probieren Sie es aus

API-Schlüssel

Sie benötigen einen API-Schlüssel, um die Endpunkte zu testen.

E-Mail-Adresse oder Domain

Versuchen Sie es mit:

Whitelist & Blacklist

Steuern Sie, welche E-Mails und Domains blockiert werden – mit benutzerspezifischen Blacklist- und Whitelist-Regeln. Diese Listen setzen das block-Feld in jeder Verifizierungsantwort.

{}

Das block-Feld

Jede Verifizierungsantwort enthält ein block-Feld. Nutzen Sie es, um anhand Ihrer Listen zu entscheiden, ob E-Mail/Domain blockiert werden soll:

trueE-Mail oder ihre Domain ist in der Blacklist → block: true. Eine hinzugefügte Domain blockiert alle E-Mails darauf.

trueWhitelist ist aktiv, E-Mail/Domain steht aber nicht darauf → block: true.

falseWhitelist ist aktiv und E-Mail oder ihre Domain steht darauf → block: false.

—Keine Liste greift → block folgt dem normalen Verifizierungsergebnis.

Überblick

✘

Blacklist

Bestimmte E-Mails oder ganze Domains immer blockieren. Beispiel: example.com in der Blacklist bedeutet, dass jede E-Mail @example.com block: true zurückgibt – unabhängig vom Verifizierungsergebnis.

✔

Whitelist

Nur bestimmte E-Mails oder Domains erlauben. Ist die Whitelist aktiv, erhalten nur Einträge daraus block: false – alles andere block: true. Beispiel: gmail.com erlaubt alle @gmail.com, user@yahoo.com wird blockiert. Bei Deaktivierung hat die Whitelist keine Wirkung.

Sie können eine vollständige E-Mail (user@example.com) oder eine Domain (example.com) hinzufügen. Eine Domain gilt für alle E-Mails auf dieser Domain. Die Groß-/Kleinschreibung wird ignoriert.

Ablauf

Reihenfolge der Auswertung

Zuerst Blacklist — Steht die E-Mail oder ihre Domain in der Blacklist, ist das Ergebnis block: true. Weitere Listenlogik wird nicht angewendet.

Whitelist (wenn aktiv) — Steht E-Mail/Domain in der Whitelist → block: false. Sonst → block: true.

Whitelist deaktiviert — Es gelten nur Blacklist und normale Verifizierung.

Die Blacklist hat immer Vorrang: Eine Adresse auf der Blacklist bleibt blockiert, auch wenn sie auf der Whitelist steht.

Was geprüft wird

E-Mail-Verifizierung – die API prüft vollständige E-Mail-Adresse und Domain gegen beide Listen. Ein Treffer wendet die Listenregel an.

Domain-Verifizierung – nur die Domain wird gegen Blacklist und (falls aktiv) Whitelist geprüft.

Kurzreferenz

Whitelist aktiv	In Blacklist	In Whitelist	block-Wert
Nein	Ja	—	`true`
Nein	Nein	—	Normal
Ja	Ja	Beliebig	`true`
Ja	Nein	Ja	`false`
Ja	Nein	Nein	`true`

Listen-API-Endpunkte

Alle Listen-Endpunkte benötigen den Header: X-API-Key: your-api-key

Blacklist

GET/v1/blacklist

Alle Blacklist-Einträge auflisten

POST/v1/blacklist

E-Mail oder Domain hinzufügen · { "value": "..." }

DELETE/v1/blacklist

Eintrag entfernen · value=...

Whitelist

GET/v1/whitelist

Alle Whitelist-Einträge auflisten

POST/v1/whitelist

E-Mail oder Domain hinzufügen · { "value": "..." }

DELETE/v1/whitelist

Eintrag entfernen · value=...

GET/v1/whitelist/enabled

Whitelist-Status abrufen · { "enabled": boolean }

PUT/v1/whitelist/enabled

Whitelist aktivieren/deaktivieren · { "enabled": true | false }

Wertformat

user@example.com — E-Mail: gültiges Format, z. B. user@example.com
example.com — Domain: gültiges Format, z. B. example.com

Ungültige Werte werden mit 400 abgelehnt. Einträge werden normalisiert gespeichert. Duplikate werden zu einem Eintrag zusammengeführt.

Wo Listen angewendet werden

Listenregeln werden nach der Verifizierung angewendet. Einzel- und Batch-E-Mail- sowie Domain-Verifizierung enthalten das block-Feld bereits inkl. Blacklist und Whitelist des Nutzers.

MCP-Server (Integration von AI-Agenten)

Integrieren Sie die E-Mail-Überprüfung direkt in KI-Agenten wie Cursor und Claude Desktop mithilfe des Model Context Protocol (MCP). Ihr KI-Assistent kann E-Mails verifizieren, Domänen prüfen und die Syntax validieren, ohne den Editor zu verlassen.

Einrichtung

Fügen Sie die folgende Konfiguration zu Ihrer Konfigurationsdatei .cursor/mcp.json oder Claude Desktop hinzu:

{
  "mcpServers": {
    "email-checker": {
      "url": "https://api.verify-email.app/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Verfügbare Tools

Werkzeug	Beschreibung	Eingabe	Kredite
verify_email	Vollständige E-Mail-Überprüfung einschließlich Syntax-, MX-, SMTP-, Wegwerf-, Datenschutz- und Zustellbarkeitsprüfungen	{ email: string }	1
verify_domain	Vollständige Domainüberprüfung, einschließlich MX-Einträge, Wegwerf-, Datenschutz- und Catch-All-Erkennung	{ domain: string }	1
check_deliverability	Schnelle Zustellbarkeitsprüfung mit MX- und SMTP-Verifizierung ohne externe API-Aufrufe	{ email: string }	1
verify_batch	Batch-Überprüfung für bis zu 100 E-Mails oder Domains in einer einzigen Anfrage	{ inputs: string[] }	1 per item
validate_email_syntax	Schnelle lokale Syntaxvalidierung gegen RFC 5322 ohne Netzwerkaufrufe	{ email: string }	0 (free)