GET /v1/validation/status/{uuid}
Restituisce lo stato di una validazione creata con bulk o file. Una volta terminata, include anche il conteggio degli indirizzi validi e non validi.
Aspetta che lo stato sia COMPLETED prima di scaricare i dettagli: fino ad allora il risultato è incompleto.
Endpoint
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"Parametri del percorso
| Campo | Tipo | Descrizione |
|---|---|---|
uuid | string | Identificatore restituito alla creazione della validazione. |
Risposta
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"
}
}| Campo | Tipo | Descrizione |
|---|---|---|
status | string | Stato della validazione. Vedi Stati. |
uuid | string | Identificatore della validazione. |
created_at | string | Data di creazione della validazione (YYYY-MM-DD HH:MM:SS). |
totalEmails | int | Numero di indirizzi nella validazione. |
invalidEmails | int | Indirizzi non validi. Solo quando lo stato è COMPLETED. |
validEmails | int | Indirizzi validi. Solo quando lo stato è COMPLETED. |
fileStatus | string | Stato del file. Solo nelle validazioni create da un file. |
Campi condizionali
invalidEmails e validEmails compaiono solo quando lo stato è COMPLETED, e fileStatus solo nelle validazioni create con file. Non dare per scontato che siano presenti.
Errori
| Codice | HTTP | Quando |
|---|---|---|
1301 | 404 | Lo uuid non esiste o non appartiene al tuo account. |
1303 | 500 | Consultazione della validazione fallita. |
Passo successivo
Quando lo stato è COMPLETED, scarica il risultato per indirizzo in GET /v1/validation/details/{uuid}/{page}.
