---
title: "List app passwords (hosted)"
method: GET
path: "/api/emails/{address}/credentials"
tags: ["Email"]
---

# List app passwords (hosted)

`GET /api/emails/{address}/credentials`

## Request

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

List the app passwords for a hosted mailbox. Secrets are shown only once at creation; this returns labels and metadata only. Hosted mailboxes only.

## Path parameters

- `address` string, required

## Response `200`

App password list

- object
  - `mailbox` string
  - `credentials` object[]
    - `id` string
    - `label` string
    - `created_at` string, date-time
    - `last_used_at` string, date-time, nullable
    - `created_by` object, nullable
      - `type` 'user' | 'token' | 'agent'
      - `id` string
      - `label` string
  - `hint` string

---

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