---
title: "List mailboxes"
method: GET
path: "/domains/{domain}/mailboxes"
tags: ["Mailboxes"]
---

# List mailboxes

`GET /domains/{domain}/mailboxes`

Retrieves all mailboxes configured for the specified domain

## Path parameters

- `domain` string, required

## Response `200`

Successfully retrieved mailboxes

- RestmailstackMailboxesResponse — Response containing list of mailboxes and status
  - `mailboxes` RestmailstackMailboxRecord[] — List of mailboxes required: false
    - `email` string — Email address for the mailbox required: true format: email example: user@example.com
    - `forwardingEnabled` boolean — Email forwarding status required: true default: false
    - `forwardingTo` string[] — List of forwarding email addresses required: false maxItems: 10
    - `password` string — Mailbox password (only included in specific responses) required: false minLength: 8 maxLength: 64
    - `webmailEnabled` boolean — Webmail access status required: true default: false
  - `requestId` string
  - `status` string — Status indicates the result of the operation ("success" or "error")

## Other responses

- `400` — Missing domain parameter
- `401` — Unauthorized - Missing or invalid API key
- `404` — Domain not found
- `500` — Internal server error

## Changes

- **2026-07-17** `73526747b270` — 1 info
  - endpoint added
- **2024-09-10** `1ee4ed170cfa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/customeros/apis/customeros-api/changes/domains/:domain/mailboxes/get.md)

---

[API](https://skmtc.dev/customeros/apis/customeros-api.md) · [All operations](https://skmtc.dev/customeros/apis/customeros-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customeros/customeros-api/revisions/73526747b270/schema)