---
title: "List all mailboxes"
method: GET
path: "/api/emails"
tags: ["Email"]
---

# List all mailboxes

`GET /api/emails`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/emails`
- Auth: HTTP bearer

List every mailbox the acting principal can access, including workspace grants. Same as GET /api/email.

## Query parameters

- `domain` string

## Response `200`

Mailbox list

- object
  - `mailboxes` object[]
    - `id` string
    - `address` string
    - `slug` string
    - `domain` string
    - `message_count` integer
    - `webhook_url` string, nullable
    - `header_names` string[]: Configured webhook authentication header names; values are never returned
    - `forward_to` string, nullable
    - `workspace_id` string, nullable
    - `access_role` 'viewer' | 'responder' | 'manager'
    - `effective_capabilities` string[]: Concrete permissions already intersected with mailbox role, workspace entitlement, and token scopes. Clients should render from these values instead of inferring behavior from access_role.
    - `collaboration_enabled` boolean
    - `shared` boolean: Whether at least one principal other than the caller can read this mailbox
    - `storage_quota_bytes` integer, nullable
    - `storage_used_bytes` integer, nullable
    - `storage_measured_at` string, date-time, nullable

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)