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

# List Mailboxes

`GET /mailboxes`

## Request

- Base URL: `https://public.outreach2day.com`
- URL: `https://public.outreach2day.com/mailboxes`
- Auth: HTTP bearer

List all mailboxes for a user or a specific workspace.

- If workspace_id is provided, it will return mailboxes for that specific workspace.
- If workspace_id is not provided, it will return mailboxes for all workspaces of the user.

## Query parameters

- `workspace_id` integer, required

## Response `200`

Successful Response

- MailboxInfo[]
  - `id` integer, required
  - `first_name` string, nullable, required
  - `last_name` string, nullable, required
  - `address` string, nullable, required
  - `domain_id` integer, nullable, required
  - `status` string, nullable
  - `password` string, nullable, required
  - `forward_to` string, nullable, required
  - `signature` string, nullable, required
  - `enable_forwarding` boolean, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/outreach2day/apis/outreach-today-public-api.md) · [All operations](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/revisions/0e5471143371?raw)