Zum Hauptinhalt springen
GET
/
v1
E-Mail-Validierungs-API
curl --request GET \
  --url https://emailvalidation.cleariflow.com/v1
{
  "email": "jane.doe@acme-corp.com",
  "autocorrect": "",
  "deliverability": "DELIVERABLE",
  "quality_score": 0.85,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": true,
    "text": "TRUE"
  },
  "is_smtp_valid": {
    "value": true,
    "text": "TRUE"
  }
}

​
Schnellstart

Für eine Anfrage benötigen Sie nur Ihren eindeutigen api_key und die zu prüfende email — mehr ist nicht erforderlich: 
https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = jane.doe@acme-corp.com
Bei Erfolg liefert die Anfrage alle verfügbaren Erkenntnisse zur Adresse: 
{
  "email": "jane.doe@acme-corp.com",
  "autocorrect": "",
  "deliverability": "DELIVERABLE",
  "quality_score": 0.85,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": true,
    "text": "TRUE"
  },
  "is_smtp_valid": {
    "value": true,
    "text": "TRUE"
  }
}

​
Anfrageparameter

​
api_key
string
erforderlich
Ihre persönlichen API-Zugangsdaten. Schlüssel sind pro Cleariflow-Produkt begrenzt — ein E-Mail-Validierungsschlüssel berechtigt z. B. nicht zu Anfragen an die IP-Geolokalisierungs-API.
​
email
String
erforderlich
Die zu prüfende E-Mail-Adresse.
​
auto_correct
Boolean
Optionales Flag zum Deaktivieren der Autokorrektur. Setzen Sie auto_correct=false, um sie auszuschalten. Standardmäßig ist sie aktiviert.

​
Antwortparameter

Antworten werden als kompaktes, standardisiertes JSON zurückgegeben.
​
email
String
Gibt die in der Anfrage übermittelte email zurück.
​
auto_correct
String
Vorgeschlagene Korrektur, wenn ein wahrscheinlicher Tippfehler erkannt wird (z. B. johnsmith@gmial.com => johnsmith@gmail.com). Leer, wenn kein Vorschlag vorliegt.
​
deliverability
String
Cleariflows Einschätzung, ob die Adresse E-Mails empfangen kann. Mögliche Werte: DELIVERABLE, UNDELIVERABLE, UNKNOWN. In kostenpflichtigen Plänen erfordert DELIVERABLE eine erfolgreiche SMTP-Prüfung; wenn MX-Einträge vorhanden sind, SMTP das Postfach aber nicht bestätigen kann (häufig bei großen Anbietern), ist das Ergebnis UNKNOWN. In Free-Plänen ist der Wert UNKNOWN, sofern die Adresse nicht eindeutig undeliverable ist (ungültiges Format oder Disposable-Domain).
​
quality_score
Float
Dezimalwert von 0 bis 0.99 für die Adressqualität. Disposable-Adressen sind auf etwa 0.05 begrenzt; ohne SMTP-Bestätigung maximal 0.55.
​
is_valid_format
Boolean
true, wenn die Adresse dem Standardmuster local@domain.tld entspricht. Fehlende Elemente oder ungültige Zeichen ergeben false.
​
is_free_email
Boolean
true, wenn die Domain zu einem kostenlosen E-Mail-Anbieter gehört (z. B. Gmail, Yahoo).
​
is_disposable_email
Boolean
true, wenn die Domain auf unserer Liste temporärer Wegwerf-Postfach-Anbieter steht (z. B. Mailinator, Yopmail).
​
is_role_email
Boolean
true, wenn der lokale Teil wie ein Funktionspostfach und nicht wie eine Einzelperson wirkt, z. B. team@, sales@, info@.
​
is_catchall_email
Boolean
true, wenn die Domain als Catch-all konfiguriert ist. Nur in kostenpflichtigen Tarifen verfügbar; in kostenlosen Tarifen null/UNKNOWN.
​
is_mx_found
Boolean
true, wenn MX-Records für die Domain existieren. Nur in kostenpflichtigen Tarifen verfügbar; in kostenlosen Tarifen null/UNKNOWN.
​
is_smtp_valid
Boolean
true, wenn die SMTP-Verifizierung erfolgreich ist. Schlägt SMTP fehl, andere Prüfungen aber bestehen, kann das Ergebnis UNKNOWN sein. Wir raten davon ab, Registrierungen oder Formularübermittlungen allein aufgrund von SMTP-Fehlern zu blockieren. Nur in kostenpflichtigen Tarifen verfügbar; in kostenlosen Tarifen null/UNKNOWN.

​
Anfragebeispiele

​
Beispiel: wahrscheinlicher Tippfehler

Dieses Beispiel zeigt eine Anfrage, bei der in der übermittelten Adresse ein wahrscheinlicher Tippfehler erkannt wird. Auch wenn ein wahrscheinlicher Tippfehler gefunden wird, werden alle weiteren Prüfungen (z. B. kostenlose E-Mail, Wegwerf-Domain) gegen die ursprünglich übermittelte Adresse durchgeführt — nicht gegen den vorgeschlagenen Korrekturvorschlag. 
https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = johnsmith@gmial.con
Eine erfolgreiche Antwort sieht so aus: 
{
  "email": "johnsmith@gmial.con",
  "autocorrect": "johnsmith@gmail.com",
  "deliverability": "UNKNOWN",
  "quality_score": 0.4,
  "is_valid_format": {
    "value": true,
    "text": "TRUE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": null,
    "text": "UNKNOWN"
  },
  "is_mx_found": {
    "value": null,
    "text": "UNKNOWN"
  },
  "is_smtp_valid": {
    "value": null,
    "text": "UNKNOWN"
  }
}

​
Beispiel: ungültiges Format

Dieses Beispiel zeigt eine Adresse, die die grundlegende Formatprüfung nicht besteht. Wenn is_valid_format false ist, werden nachfolgende Prüfungen (z. B. is_free_email, is_role_email) übersprungen und als false gemeldet. 
https://emailvalidation.cleariflow.com/v1/
? api_key = YOUR_UNIQUE_API_KEY
& email = johnsmith
Eine erfolgreiche Antwort sieht so aus: 
{
  "email": "johnsmith",
  "autocorrect": "",
  "deliverability": "UNDELIVERABLE",
  "quality_score": 0.0,
  "is_valid_format": {
    "value": false,
    "text": "FALSE"
  },
  "is_free_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_disposable_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_role_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_catchall_email": {
    "value": false,
    "text": "FALSE"
  },
  "is_mx_found": {
    "value": false,
    "text": "FALSE"
  },
  "is_smtp_valid": {
    "value": false,
    "text": "FALSE"
  }
}

​
Massen-Upload (CSV)

Möchten Sie die API nicht direkt aufrufen? Nutzen Sie den CSV-Massen-Upload — die Ergebnisse werden Ihnen per E-Mail zugestellt, sobald die Verarbeitung abgeschlossen ist. Beim CSV-Upload beachten Sie bitte:
  • E-Mail-Adressen in die erste Spalte eintragen.
  • Leere Zeilen entfernen.
  • Eine Adresse pro Zeile verwenden.
  • Dateien auf maximal 50.000 Zeilen begrenzen.

​
Antwort- und Fehlercodes

Fehler werden als JSON mit Code und lesbarer Beschreibung zurückgegeben. Häufige Codes sind unten aufgeführt.
CodeTypBeschreibung
200OKAnfrage erfolgreich abgeschlossen.
400Bad requestFehlerhafte oder ungültige Anfrage.
401UnauthorizedAuthentifizierung fehlgeschlagen — in der Regel fehlt der API-Schlüssel oder er ist ungültig.
422Quota reachedKontingent erschöpft (z. B. unzureichendes Guthaben bei kostenlosen Tarifen).
429Too many requestsRatenlimit überschritten (kostenlose Tarife: maximal 1 Anfrage/Sekunde).
500Internal server errorUnerwarteter Fehler auf unserer Seite.
503Service unavailableDienst vorübergehend nicht verfügbar.

​
Weitere Hinweise

Hinweis zur Abrechnung: Jede geprüfte E-Mail verbraucht ein Guthaben pro Anfrage — unabhängig vom Ergebnis. Die Übermittlung einer ungültigen Adresse (z. B. „fda3346ds”) zählt ebenfalls als ein Guthaben.