Skip to content

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 ​

FeldTypBeschreibung
uuidstringKennung, die beim Erstellen der Validierung zurückkam.
pageintZurü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
  }
}
FeldTypBeschreibung
statusstringStatus der Validierung. Siehe Status.
uuidstringKennung der Validierung.
created_atstringErstellungsdatum der Validierung (YYYY-MM-DD HH:MM:SS).
emailsarrayErgebnis pro Adresse für diese Seite.
emails[].emailstringGeprüfte Adresse.
emails[].statusstringsuccess oder error: ob die Prüfung durchgeführt werden konnte.
emails[].classificationstring oder nullvalid, invalid, risky, unknown oder catch_all; null bei Fehler.
emails[].reasonstring oder nullGrund, wenn das Ergebnis nicht valid ist.
emails[].reason_codestring oder nullStabiler Code für das Ergebnis.
emails[].advancedboolOb das Postfach tatsächlich abgefragt wurde.
pagesintGesamtzahl der Seiten.
currentPageintZurü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 ​

CodeHTTPWann
1001400page ist kleiner als 1.
1301404Die uuid existiert nicht oder gehört nicht zu deinem Konto.
1303500Abfrage der Validierung fehlgeschlagen.

Verwandte Endpunkte ​

Built with VitePress