---
title: "List mailboxes on a domain"
method: GET
path: "/api/v1/domains/{id}/mailboxes"
tags: ["Mailboxes"]
---

# List mailboxes on a domain

`GET /api/v1/domains/{id}/mailboxes`

## Request

- Base URL: `https://justemails.app`
- URL: `https://justemails.app/api/v1/domains/{id}/mailboxes`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- object
  - `data` Mailbox[], required
    - `id` string, uuid
    - `domainId` string, uuid
    - `address` string
    - `displayName` string, nullable
    - `mailboxType` 'shared' | 'personal'
    - `hasCustomPassword` boolean
  - `meta` object

---

[API](https://skmtc.dev/justemails/apis/justemails-api.md) · [All operations](https://skmtc.dev/justemails/apis/justemails-api/llms.txt) · [OpenAPI document](https://skmtc.dev/justemails/apis/justemails-api/revisions/3bd7e6b390c5?raw)