---
title: "List mailboxes"
method: GET
path: "/mailboxes"
tags: ["Mailboxes"]
---

# List mailboxes

`GET /mailboxes`

## Request

- Base URL: `https://faivelo.com/api/v1`
- URL: `https://faivelo.com/api/v1/mailboxes`
- Auth: HTTP bearer

Returns all mailboxes, optionally filtered by domain. Requires scope `mailboxes:read`. Mailbox-restricted keys only see their bound mailbox; agent keys only see mailboxes they created or were granted.

## Query parameters

- `domain` string

## Response `200`

Mailbox list

- object
  - `success` boolean
  - `data` Mailbox[]
    - `localPart` string
    - `fullAddress` string
    - `displayName` string, nullable
    - `active` boolean
    - `createdAt` string, date-time
    - `storage` object, nullable: On `GET /mailboxes/{address}` only: bytes used and the quota the mail server enforces, read live. Null when the server could not answer.
      - `usedBytes` integer
      - `limitBytes` integer, nullable
      - `availableBytes` integer, nullable

## Other responses

- `401`: Missing or invalid API key
- `402`: The account's plan does not include the API (`plan_required`)
- `403`: The key lacks the required scope
- `429`: Rate limit exceeded

---

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