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. [email protected] 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": "[email protected]",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Code-Beispiele

curl "https://api.verify-email.app/v1/[email protected]" \
  -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": [
      "[email protected]",
      "[email protected]"
    ]
  }'

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. [email protected]). 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": "[email protected]",
  "remaining_credits": 99
}

Code-Beispiele

curl "https://api.verify-email.app/v1/verify/[email protected]" \
  -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, [email protected] wird blockiert. Bei Deaktivierung hat die Whitelist keine Wirkung.

Sie können eine vollständige E-Mail ([email protected]) 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 }

Code-Beispiele (cURL)

✘

Blacklist

GET/v1/blacklist

Alle Blacklist-Einträge auflisten

curl "https://api.verify-email.app/v1/blacklist" \
  -H "X-API-Key: your-api-key"

POST/v1/blacklist

E-Mail oder Domain hinzufügen

curl -X POST "https://api.verify-email.app/v1/blacklist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/blacklist

Eintrag entfernen

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

✔

Whitelist

GET/v1/whitelist

Alle Whitelist-Einträge auflisten

curl "https://api.verify-email.app/v1/whitelist" \
  -H "X-API-Key: your-api-key"

POST/v1/whitelist

E-Mail oder Domain hinzufügen

curl -X POST "https://api.verify-email.app/v1/whitelist" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "value": "[email protected]"
  }'

DELETE/v1/whitelist

Eintrag entfernen

curl -X DELETE "https://api.verify-email.app/v1/[email protected]" \
  -H "X-API-Key: your-api-key"

GET/v1/whitelist/enabled

Whitelist-Status abrufen

curl "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "X-API-Key: your-api-key"

PUT/v1/whitelist/enabled

Whitelist aktivieren/deaktivieren

curl -X PUT "https://api.verify-email.app/v1/whitelist/enabled" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "enabled": true
  }'

Wertformat

[email protected] — E-Mail: gültiges Format, z. B. [email protected]
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.

Docs endpoint for AI agents

The API exposes a machine-readable docs endpoint (no API key required) so AI agents and MCP clients can discover the server, available tools, and auth requirements. Use this URL in your agent or MCP configuration.

GET /v1/mcp/docs

Returns JSON with server name, description, serverUrl, docsEndpoint, authentication details, and full tool definitions.

curl "https://api.verify-email.app/v1/mcp/docs"

AI agents can GET this URL to receive server metadata, tool schemas, and integration instructions in JSON. No authentication is required for the docs endpoint.

Open docs endpoint How to add in Cursor How to add in Claude

Integration details

Authentication

All MCP tool calls require your API key in the X-API-Key header. Get your key from the dashboard.

MCP server URL: https://api.verify-email.app/mcp

Docs endpoint (for agents): https://api.verify-email.app/v1/mcp/docs

Cursor

Add the server in Cursor Settings → Tools & MCP, or add the config to .cursor/mcp.json in your project or home directory.

Claude Desktop

Add the server to your Claude Desktop config (mcpServers in claude_desktop_config.json). Use the server URL and X-API-Key header as shown below.

Response format

Tool results match the REST API response shape (valid, block, deliverable, remaining_credits, etc.). Use the block field for blacklist/whitelist decisions.

This MCP server is production-ready and uses the same API as the REST endpoints. Credits are consumed per verification as with the REST API.

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)