Elenco delle caselle

Restituisce le caselle di posta di un dominio, con spazio occupato e protocolli abilitati.

• Metodo: GET
• Indirizzo: https://console.icbs.it/api/v1/email/{dominio}/accounts
• Permesso: Email — lettura

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
dominio	indirizzo	sì	Il nome a dominio, per esempio esempio.it.

Esempio di richiesta

curl -H "Authorization: Bearer $ICBS_API_KEY" \
  https://console.icbs.it/api/v1/email/esempio.it/accounts

Esempio di risposta

{
  "domain": "esempio.it",
  "data": [
    {
      "id": 318,
      "address": "info@esempio.it",
      "name": "Informazioni",
      "active": true,
      "quotaBytes": 5368709120,
      "usedBytes": 1288490188,
      "lastLoginAt": "2026-08-05T18:42:00.000Z",
      "protocols": { "imap": true, "pop3": false, "smtp": true }
    }
  ]
}

Campi della risposta

Campo	Descrizione
id	Identifica la casella nelle chiamate di modifica ed eliminazione.
address	L'indirizzo completo della casella.
active	Se la casella è attiva. Una casella disattivata non riceve né invia.
quotaBytes	Spazio assegnato, null se illimitato.
usedBytes	Spazio occupato dalla posta.
lastLoginAt	Ultimo accesso alla casella, null se non ha mai effettuato l'accesso.
protocols	Quali protocolli sono abilitati per questa casella.

lastLoginAt è il dato più utile per la manutenzione periodica: una casella che non viene aperta da mesi ma occupa spazio è quasi sempre da chiudere.

Le password non compaiono

Questa chiamata non restituisce le password delle caselle.

Possibili errori

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.