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
| Feld | Typ | Beschreibung |
|---|---|---|
uuid | string | Kennung, 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"
}
}| 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). |
totalEmails | int | Anzahl der Adressen in der Validierung. |
invalidEmails | int | Ungültige Adressen. Nur wenn der Status COMPLETED ist. |
validEmails | int | Gültige Adressen. Nur wenn der Status COMPLETED ist. |
fileStatus | string | Dateistatus. 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
| Code | HTTP | Wann |
|---|---|---|
1301 | 404 | Die uuid existiert nicht oder gehört nicht zu deinem Konto. |
1303 | 500 | Abfrage der Validierung fehlgeschlagen. |
Nächster Schritt
Sobald der Status COMPLETED ist, lade das Ergebnis pro Adresse in GET /v1/validation/details/{uuid}/{page} herunter.
