Skip to content

POST /v1/validation/single-email ​

Validiert eine einzelne Adresse und liefert das Ergebnis sofort. Er ist der einzige synchrone Endpunkt der Validierungs-API: er gibt die uuid der Validierung zurück, aber danach gibt es nichts abzufragen, weil das Ergebnis schon in der Antwort steht.

Er verbraucht ein Validierungsguthaben, egal wie die Einstufung ausfällt. Hast du kein Guthaben mehr, wird die Anfrage mit Code 1304 abgelehnt.

Endpunkt ​

http
POST /v1/validation/single-email
bash
curl -X POST https://api.mailiqo.com/v1/validation/single-email \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Anfragekörper ​

FeldTypPflichtBeschreibung
emailstringJaZu validierende E-Mail-Adresse.

Antwort ​

Code 201. Die Antwort hat dieselbe Form wie das Detail einer Massenvalidierung, mit einer einzigen Adresse: oben die Daten der Validierung und das Ergebnis in email.

json
{
  "status": "success",
  "data": {
    "status": "COMPLETED",
    "uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx",
    "created_at": "2026-01-01 10:29:07",
    "email": {
      "email": "[email protected]",
      "status": "success",
      "classification": "valid",
      "reason": "Mailbox exists",
      "reason_code": "mailbox_exists",
      "advanced": true
    }
  }
}
FeldTypBeschreibung
statusstringStatus der Validierung. Siehe Status.
uuidstringKennung der Validierung.
created_atstringErstellungsdatum der Validierung (YYYY-MM-DD HH:MM:SS).
email.emailstringGeprüfte Adresse.
email.statusstringsuccess oder error: ob die Prüfung durchgeführt werden konnte.
email.classificationstring oder nullvalid, invalid, catch_all, risky oder unknown; null bei Fehler.
email.reasonstring oder nullLesbarer Grund für das Ergebnis.
email.reason_codestring oder nullStabiler Code für das Ergebnis.
email.advancedboolOb das Postfach tatsächlich abgefragt wurde.

In dieser Antwort gibt es zwei status-Felder

Das äußere ist der Status der Validierung (COMPLETED, ERROR...). Das in email ist die Prüfung dieser Adresse. Ob die Adresse gut ist, liest du an classification ab, nicht an status. Siehe Das Ergebnis einer Adresse.

classification ist kein Boolean

Eine nicht zustellbare Adresse ist nicht zwangsläufig invalid: sie kann catch_all, risky oder unknown sein. Entscheide anhand der vollständigen Einstufung, nicht anhand einer gültig/ungültig-Gleichsetzung. Siehe Einstufungen.

Fehler ​

CodeHTTPWann
1313400Das Feld email fehlt.
1304400Nicht genügend Validierungsguthaben.
1314500Die Prüfung ist im Validierungsdienst fehlgeschlagen.

Die vollständige Liste findest du in der Fehlerreferenz.

Verwandte Endpunkte ​

Built with VitePress