---
title: "Get mailbox details"
method: GET
path: "/api/emails/{address}"
tags: ["Email"]
---

# Get mailbox details

`GET /api/emails/{address}`

## Request

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

Get details for a specific mailbox by its full email address (URL-encoded, e.g. hello%40mysite.com).

## Path parameters

- `address` string, required

## Response `200`

Mailbox details. Manager-only secrets are redacted for viewers/responders.

- object
  - `id` string
  - `address` string
  - `slug` string
  - `domain` string
  - `kind` string
  - `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.
  - `webhook_url` string, nullable
  - `forward_to` string, nullable
  - `signing_secret` string, nullable: HMAC secret for managers; null for viewers/responders
  - `message_count` integer
  - `storage_quota_bytes` integer, nullable
  - `storage_used_bytes` integer, nullable
  - `storage_measured_at` string, date-time, nullable
  - `created_at` string, date-time

---

[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)