API-Dokumente zur E-Mail-Validierung

API-Status

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

NameTypErforderlichBeschreibung
inputstringJaZu überprüfende E-Mail-Adresse oder Domäne (z. B. [email protected] oder example.com)

apiDocs.responseFields

FeldBeschreibung
validZeigt an, ob das E-Mail-Format korrekt ist
blockGibt an, ob die E-Mail blockiert werden soll (true, wenn disposable, privacy, applePrivateEmail, deliverable oder catch_all true ist)
disposableBestimmt, ob die E-Mail-Adresse eine temporäre oder eine Wegwerf-E-Mail-Adresse ist
privacyErmittelt, ob der Mailserver einen E-Mail-Alias oder Forwarder verwendet
applePrivateEmailGibt an, ob es sich bei der E-Mail um eine private Apple-E-Mail-Adresse handelt.
deliverablePrüft, ob die Mailbox existiert und E-Mails empfangen kann
domainDer Domänenteil der E-Mail Adresse
email_addressDie E-Mail Adresse
catch_allZeigt 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_foundZeigt an, ob die Domäne über gültige Mailserver (MX-Einträge) verfügt.
remaining_creditsDie Anzahl der verbleibenden API-Guthaben auf Ihrem Konto

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

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

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

NameTypErforderlichBeschreibung
inputsarray of stringsJaEine 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

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

Versuchen Sie es mit verschiedenen Domains: