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
POST /v1/validation/single-emailcurl -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
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
email | string | Sì | 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.
{
"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
}
}
}| 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). |
email.email | string | Indirizzo controllato. |
email.status | string | success o error: se il controllo è stato possibile. |
email.classification | string o null | valid, invalid, catch_all, risky o unknown; null in caso di errore. |
email.reason | string o null | Motivo leggibile del risultato. |
email.reason_code | string o null | Codice stabile del risultato. |
email.advanced | bool | Se 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
| Codice | HTTP | Quando |
|---|---|---|
1313 | 400 | Manca il campo email. |
1304 | 400 | Crediti di validazione insufficienti. |
1314 | 500 | Il controllo è fallito nel servizio di validazione. |
Vedi il riferimento degli errori per la lista completa.
Endpoint correlati
POST /v1/validation/bulk— valida molti indirizzi insiemePOST /v1/validation/file— valida gli indirizzi di un file- Validazione dei destinatari — valida durante l'invio, senza chiamare questa API
