Skip to content

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 ​

CampoTipoDescrizione
uuidstringIdentificatore restituito alla creazione della validazione.
pageintPagina 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
  }
}
CampoTipoDescrizione
statusstringStato della validazione. Vedi Stati.
uuidstringIdentificatore della validazione.
created_atstringData di creazione della validazione (YYYY-MM-DD HH:MM:SS).
emailsarrayRisultato per indirizzo di questa pagina.
emails[].emailstringIndirizzo controllato.
emails[].statusstringsuccess o error: se il controllo è stato possibile.
emails[].classificationstring o nullvalid, invalid, risky, unknown o catch_all; null in caso di errore.
emails[].reasonstring o nullMotivo quando il risultato non è valid.
emails[].reason_codestring o nullCodice stabile del risultato.
emails[].advancedboolSe la casella è stata effettivamente sondata.
pagesintNumero totale di pagine.
currentPageintPagina 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 ​

CodiceHTTPQuando
1001400page è inferiore a 1.
1301404Lo uuid non esiste o non appartiene al tuo account.
1303500Consultazione della validazione fallita.

Endpoint correlati ​

Built with VitePress