GET /v1/validation/details/{uuid}/{page}
Liefert das Ergebnis einer Validierung pro Adresse, seitenweise zu je 1.000.
Prüfe vor dem Aufruf mit GET /v1/validation/status/{uuid}, dass der Status COMPLETED ist: bis dahin ist das Ergebnis unvollständig.
Endpunkt
http
GET /v1/validation/details/{uuid}/{page}bash
curl -X GET https://api.mailiqo.com/v1/validation/details/6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx/1 \
-H "X-API-KEY: YOUR_API_KEY"Pfadparameter
| Feld | Typ | Beschreibung |
|---|---|---|
uuid | string | Kennung, die beim Erstellen der Validierung zurückkam. |
page | int | Zurückzugebende Seite. Beginnt bei 1; ein kleinerer Wert liefert 1001. |
Nutze pages aus der Antwort, um zu wissen, wie viele Seiten du durchlaufen musst.
Antwort
json
{
"status": "success",
"data": {
"status": "COMPLETED",
"uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx",
"created_at": "2026-01-01 10:29:07",
"emails": [
{
"email": "[email protected]",
"status": "success",
"classification": "valid",
"reason": null,
"reason_code": "smtp_accepted",
"advanced": true
},
{
"email": "[email protected]",
"status": "success",
"classification": "invalid",
"reason": "Mailbox not found",
"reason_code": "smtp_rejected",
"advanced": true
}
],
"pages": 1,
"currentPage": 1
}
}| 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). |
emails | array | Ergebnis pro Adresse für diese Seite. |
emails[].email | string | Geprüfte Adresse. |
emails[].status | string | success oder error: ob die Prüfung durchgeführt werden konnte. |
emails[].classification | string oder null | valid, invalid, risky, unknown oder catch_all; null bei Fehler. |
emails[].reason | string oder null | Grund, wenn das Ergebnis nicht valid ist. |
emails[].reason_code | string oder null | Stabiler Code für das Ergebnis. |
emails[].advanced | bool | Ob das Postfach tatsächlich abgefragt wurde. |
pages | int | Gesamtzahl der Seiten. |
currentPage | int | Zurückgegebene Seite. |
Die Ergebnisse kommen von der neuesten Prüfung zur ältesten zurück.
In dieser Antwort gibt es zwei status-Felder
Das äußere ist der Status der Validierung (COMPLETED, RUNNING...). Das in jedem emails[] ist die jeweilige Prüfung: success oder error. Ob eine Adresse gut ist, liest du an classification ab, nicht an status. Siehe Das Ergebnis einer Adresse.
Fehler
| Code | HTTP | Wann |
|---|---|---|
1001 | 400 | page ist kleiner als 1. |
1301 | 404 | Die uuid existiert nicht oder gehört nicht zu deinem Konto. |
1303 | 500 | Abfrage der Validierung fehlgeschlagen. |
Verwandte Endpunkte
GET /v1/validation/status/{uuid}— prüfen, ob sie abgeschlossen istPOST /v1/validation/bulk— die Validierung erstellen
