---
title: "List Messages"
method: GET
path: "/mailbox/{mailbox_uid}/messages"
---

# List Messages

`GET /mailbox/{mailbox_uid}/messages`

## Request

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

List messages for a Mail Box.

## Path parameters

- `mailbox_uid` string, required

## Query parameters

- `filter.unread` boolean
- `filter.starred` boolean
- `filter.any_email` string
- `filter.from` string
- `filter.to` string
- `filter.has_attachment` boolean
- `filter.subject` string
- `page` integer
- `limit` integer
- `sort` 'asc' | 'desc'

## Response `200`

- object
  - `type` string
  - `data` object
    - `messages` object[]
      - `attachments` object[]
        - `content_disposition` string
        - `content_type` string
        - `filename` string, nullable
        - `content_id` string
        - `size` integer
      - `bcc` object[]
        - `name` string
        - `email` string
      - `body` string
      - `cc` object[]
        - `name` string
        - `email` string
      - `date` integer
      - `folders` string[]
      - `from` object[]
        - `name` string
        - `email` string
      - `mailbox_uid` string
      - `headers` object[]
        - `name` string
        - `value` string
      - `message_id` string
      - `in_reply_to` string
      - `metadata` object
      - `object` string
      - `raw_mime` string
      - `reply_to` object[]
        - `name` string
        - `email` string
      - `snippet` string
      - `starred` boolean
      - `subject` string
      - `thread_id` string
      - `to` object[]
        - `name` string
        - `email` string
      - `tracking_options` object
        - `opens` boolean
        - `thread_replies` boolean
        - `links` boolean
        - `label` string
      - `unread` boolean

## Changes

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

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/mailbox/:mailbox_uid/messages/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)