Skip to content

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 ​

CampoTipoDescrizione
uuidstringIdentificatore 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"
  }
}
CampoTipoDescrizione
statusstringStato della validazione. Vedi Stati.
uuidstringIdentificatore della validazione.
created_atstringData di creazione della validazione (YYYY-MM-DD HH:MM:SS).
totalEmailsintNumero di indirizzi nella validazione.
invalidEmailsintIndirizzi non validi. Solo quando lo stato è COMPLETED.
validEmailsintIndirizzi validi. Solo quando lo stato è COMPLETED.
fileStatusstringStato 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 ​

CodiceHTTPQuando
1301404Lo uuid non esiste o non appartiene al tuo account.
1303500Consultazione della validazione fallita.

Passo successivo ​

Quando lo stato è COMPLETED, scarica il risultato per indirizzo in GET /v1/validation/details/{uuid}/{page}.

Built with VitePress