---
title: "GET /api/v1.0/mailboxes/"
method: GET
path: "/api/v1.0/mailboxes/"
tags: ["mailboxes"]
---

# GET /api/v1.0/mailboxes/

`GET /api/v1.0/mailboxes/`

ViewSet for Mailbox model.

## Response `200`

- Mailbox[]
  - `id` string, uuid, required — primary key for the record as UUID
  - `email` string, required
  - `name` string, nullable, required — Return the display name of the mailbox (its contact name).
  - `domain_id` string, uuid, required
  - `is_identity` boolean, required — Whether this mailbox identifies a person (i.e. is not an alias or a group)
  - `is_shared` boolean, required — Return True if the mailbox is shared (non-identity or has more than one access). Drives mailbox-level UI gating for collaboration features (assignment sub-folders, mention folder) that have no purpose in a mono-user identity mailbox.
  - `role` 'viewer' | 'editor' | 'sender' | 'admin', required
  - `count_unread_threads` integer, required — Return the number of threads with unread messages in the mailbox.
  - `count_threads` integer, required — Return the number of threads in the mailbox.
  - `count_delivering` integer, required — Return the number of threads with messages being delivered.
  - `count_unread_mentions` integer, required — Return the number of threads with unread mentions for the current user.
  - `count_assigned` integer, required — Return the number of threads in this mailbox currently assigned to the current user.
  - `abilities` object, required — Instance permissions and capabilities
    - `get` boolean, required — Can read
    - `post` boolean, required — Can create
    - `put` boolean, required — Can update
    - `patch` boolean, required — Can partially update
    - `delete` boolean, required — Can delete
    - `manage_accesses` boolean, required — Can manage accesses
    - `view_messages` boolean, required — Can view mailbox messages
    - `send_messages` boolean, required — Can send messages from mailbox
    - `manage_labels` boolean, required — Can manage mailbox labels
    - `manage_message_templates` boolean, required — Can manage mailbox message templates
    - `import_messages` boolean, required — Can import messages

---

[API](https://skmtc.net/betagouv/apis/messages-api.md) · [All operations](https://skmtc.net/betagouv/apis/messages-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/betagouv/messages-api/versions/5c64242ea839/schema)