Restituisce i messaggi transitati da un dominio: mittente, destinatario, data ed esito.
È il dato da guardare quando un messaggio non arriva: dice se è partito, se è stato respinto e se il destinatario l'ha rifiutato.
GEThttps://console.icbs.it/api/v1/email/{dominio}/logs| Parametro | Posizione | Obbligatorio | Descrizione |
|---|---|---|---|
dominio | indirizzo | sì | Il nome a dominio, per esempio esempio.it. |
page | query | no | Pagina da leggere. Se omessa vale la prima. |
limit | query | no | Quanti messaggi per pagina. |
status | query | no | Filtra per esito: sent, bounced, deferred, rejected. |
search | query | no | Cerca in mittente e destinatario. |
Trovare i messaggi respinti dell'ultimo periodo:
curl -H "Authorization: Bearer $ICBS_API_KEY" \
"https://console.icbs.it/api/v1/email/esempio.it/logs?status=bounced"
{
"domain": "esempio.it",
"page": 1,
"pageCount": 43,
"total": 2117,
"data": [
{
"date": "2026-08-06T09:14:22.000Z",
"from": "info@esempio.it",
"to": "cliente@altro-dominio.it",
"status": "sent",
"sizeBytes": 24518,
"recipients": 1
}
]
}
| Valore | Significato |
|---|---|
sent | Consegnato al server del destinatario. |
bounced | Respinto: l'indirizzo non esiste o la casella rifiuta il messaggio. |
deferred | Consegna rimandata, verrà ritentata. |
rejected | Rifiutato in partenza, per esempio perché riconosciuto come indesiderato. |
Un deferred non è un errore: capita quando il server del destinatario è momentaneamente occupato. Diventa un problema solo se persiste.
Un dominio attivo produce decine di migliaia di messaggi: pageCount e total dicono quanto c'è, page quale pagina stai leggendo. Restringi con status o search invece di scorrere tutte le pagine.
| Codice | Causa |
|---|---|
401 | Chiave assente, non valida, scaduta o revocata. |
403 | Alla chiave manca il permesso Email — lettura. |
404 | Il dominio non esiste o la chiave non vi ha accesso. |
429 | Superato il limite di richieste. |