---
title: "List Mail Boxes"
method: GET
path: "/mailbox"
---

# List Mail Boxes

`GET /mailbox`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/mailbox`
- Auth: API key in header `x-api-key`

List all mail boxes accessible to the user.

## Query parameters

- `filter.provider` 'google' | 'microsoft'
- `filter.mailbox_type` 'PERSONAL' | 'SHARED'
- `filter.status` 'CONNECTED' | 'EXPIRED' | 'NOT_CONNECTED'
- `filter.email` string
- `filter.user` string

## Response `200`

- object
  - `type` string
  - `data` object[]
    - `mailbox_uid` string
    - `email` string
    - `provider` string
    - `mailbox_type` 'PERSONAL' | 'SHARED'

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/mailbox/get.md)

---

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