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
POST /v1/validation/single-emailcurl -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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
email | string | Ja | Zu 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.
{
"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
}
}
}| Feld | Typ | Beschreibung |
|---|---|---|
status | string | Status der Validierung. Siehe Status. |
uuid | string | Kennung der Validierung. |
created_at | string | Erstellungsdatum der Validierung (YYYY-MM-DD HH:MM:SS). |
email.email | string | Geprüfte Adresse. |
email.status | string | success oder error: ob die Prüfung durchgeführt werden konnte. |
email.classification | string oder null | valid, invalid, catch_all, risky oder unknown; null bei Fehler. |
email.reason | string oder null | Lesbarer Grund für das Ergebnis. |
email.reason_code | string oder null | Stabiler Code für das Ergebnis. |
email.advanced | bool | Ob 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
| Code | HTTP | Wann |
|---|---|---|
1313 | 400 | Das Feld email fehlt. |
1304 | 400 | Nicht genügend Validierungsguthaben. |
1314 | 500 | Die Prüfung ist im Validierungsdienst fehlgeschlagen. |
Die vollständige Liste findest du in der Fehlerreferenz.
Verwandte Endpunkte
POST /v1/validation/bulk— viele Adressen auf einmal validierenPOST /v1/validation/file— die Adressen einer Datei validieren- Empfängervalidierung — beim Senden validieren, ohne diese API aufzurufen
