GET /v1/validation/details/{uuid}/{page}
Restituisce il risultato per indirizzo di una validazione, paginato 1.000 alla volta.
Prima di chiamarlo, verifica con GET /v1/validation/status/{uuid} che lo stato sia COMPLETED: fino ad allora il risultato è incompleto.
Endpoint
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"Parametri del percorso
| Campo | Tipo | Descrizione |
|---|---|---|
uuid | string | Identificatore restituito alla creazione della validazione. |
page | int | Pagina da restituire. Parte da 1; un valore inferiore restituisce 1001. |
Usa pages dalla risposta per sapere quante pagine devi percorrere.
Risposta
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
}
}| 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). |
emails | array | Risultato per indirizzo di questa pagina. |
emails[].email | string | Indirizzo controllato. |
emails[].status | string | success o error: se il controllo è stato possibile. |
emails[].classification | string o null | valid, invalid, risky, unknown o catch_all; null in caso di errore. |
emails[].reason | string o null | Motivo quando il risultato non è valid. |
emails[].reason_code | string o null | Codice stabile del risultato. |
emails[].advanced | bool | Se la casella è stata effettivamente sondata. |
pages | int | Numero totale di pagine. |
currentPage | int | Pagina restituita. |
I risultati arrivano dal controllo più recente al più vecchio.
In questa risposta ci sono due campi status
Quello esterno è lo stato della validazione (COMPLETED, RUNNING...). Quello dentro ogni emails[] è quel controllo specifico: success o error. Per sapere se un indirizzo è buono, leggi classification, non status. Vedi Il risultato di un indirizzo.
Errori
| Codice | HTTP | Quando |
|---|---|---|
1001 | 400 | page è inferiore a 1. |
1301 | 404 | Lo uuid non esiste o non appartiene al tuo account. |
1303 | 500 | Consultazione della validazione fallita. |
Endpoint correlati
GET /v1/validation/status/{uuid}— verifica se è terminataPOST /v1/validation/bulk— crea la validazione
