Skip to content

POST /v1/validation/single-email ​

Valida un singolo indirizzo e restituisce il risultato immediatamente. È l'unico endpoint sincrono dell'API di validazione: restituisce lo uuid della validazione, ma non c'è nulla da consultare dopo perché il risultato è già nella risposta.

Usa un credito di validazione qualunque sia la classificazione. Se non hai più saldo, la richiesta viene rifiutata con il codice 1304.

Endpoint ​

http
POST /v1/validation/single-email
bash
curl -X POST https://api.mailiqo.com/v1/validation/single-email \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Corpo della richiesta ​

CampoTipoObbligatorioDescrizione
emailstringSìIndirizzo email da validare.

Risposta ​

Codice 201. La risposta ha la stessa forma del dettaglio di una validazione massiva, con un solo indirizzo: i dati della validazione in alto e il risultato in email.

json
{
  "status": "success",
  "data": {
    "status": "COMPLETED",
    "uuid": "6f1c0f3e-6d1a-4b7e-9d2c-xxxxxxxx",
    "created_at": "2026-01-01 10:29:07",
    "email": {
      "email": "[email protected]",
      "status": "success",
      "classification": "valid",
      "reason": "Mailbox exists",
      "reason_code": "mailbox_exists",
      "advanced": true
    }
  }
}
CampoTipoDescrizione
statusstringStato della validazione. Vedi Stati.
uuidstringIdentificatore della validazione.
created_atstringData di creazione della validazione (YYYY-MM-DD HH:MM:SS).
email.emailstringIndirizzo controllato.
email.statusstringsuccess o error: se il controllo è stato possibile.
email.classificationstring o nullvalid, invalid, catch_all, risky o unknown; null in caso di errore.
email.reasonstring o nullMotivo leggibile del risultato.
email.reason_codestring o nullCodice stabile del risultato.
email.advancedboolSe la casella è stata effettivamente sondata.

In questa risposta ci sono due campi status

Quello esterno è lo stato della validazione (COMPLETED, ERROR...). Quello dentro email è il controllo di quell'indirizzo. Per sapere se l'indirizzo è buono, leggi classification, non status. Vedi Il risultato di un indirizzo.

classification non è un booleano

Un indirizzo non raggiungibile non è necessariamente invalid: può essere catch_all, risky o unknown. Decidi in base alla classificazione completa, non a un'equivalenza valido/non valido. Vedi Classificazioni.

Errori ​

CodiceHTTPQuando
1313400Manca il campo email.
1304400Crediti di validazione insufficienti.
1314500Il controllo è fallito nel servizio di validazione.

Vedi il riferimento degli errori per la lista completa.

Endpoint correlati ​

Built with VitePress