Skip to content

GET /v1/validation/status/{uuid} ​

Liefert den Status einer Validierung, die mit bulk oder file erstellt wurde. Nach Abschluss enthält er auch die Anzahl der gültigen und ungültigen Adressen.

Warte, bis der Status COMPLETED ist, bevor du die Details herunterlädst: bis dahin ist das Ergebnis unvollständig.

Endpunkt ​

http
GET /v1/validation/status/{uuid}
bash
curl -X GET https://api.mailiqo.com/v1/validation/status/6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx \
  -H "X-API-KEY: YOUR_API_KEY"

Pfadparameter ​

FeldTypBeschreibung
uuidstringKennung, die beim Erstellen der Validierung zurückkam.

Antwort ​

json
{
  "status": "success",
  "data": {
    "status": "COMPLETED",
    "uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx",
    "created_at": "2026-01-01 10:29:07",
    "totalEmails": 1000,
    "invalidEmails": 42,
    "validEmails": 958,
    "fileStatus": "IMPORTED"
  }
}
FeldTypBeschreibung
statusstringStatus der Validierung. Siehe Status.
uuidstringKennung der Validierung.
created_atstringErstellungsdatum der Validierung (YYYY-MM-DD HH:MM:SS).
totalEmailsintAnzahl der Adressen in der Validierung.
invalidEmailsintUngültige Adressen. Nur wenn der Status COMPLETED ist.
validEmailsintGültige Adressen. Nur wenn der Status COMPLETED ist.
fileStatusstringDateistatus. Nur bei Validierungen aus einer Datei.

Bedingte Felder

invalidEmails und validEmails erscheinen nur, wenn der Status COMPLETED ist, und fileStatus nur bei Validierungen, die mit file erstellt wurden. Gehe nicht davon aus, dass sie vorhanden sind.

Fehler ​

CodeHTTPWann
1301404Die uuid existiert nicht oder gehört nicht zu deinem Konto.
1303500Abfrage der Validierung fehlgeschlagen.

Nächster Schritt ​

Sobald der Status COMPLETED ist, lade das Ergebnis pro Adresse in GET /v1/validation/details/{uuid}/{page} herunter.

Built with VitePress