---
title: "List recent messages"
method: GET
path: "/api/v1/messages"
tags: ["Messages"]
---

# List recent messages

`GET /api/v1/messages`

## Request

- Base URL: `https://supermailos.com`
- URL: `https://supermailos.com/api/v1/messages`
- Auth: HTTP bearer

Recent individual messages across the mailboxes this key can read, newest first. For conversations, prefer `GET /threads`.

## Query parameters

- `mailbox` string, email
- `folder` 'inbox' | 'sent' | 'drafts' | 'archive' | 'spam' | 'trash'
- `direction` 'inbound' | 'outbound'
- `limit` integer

## Response `200`

Messages.

- object
  - `messages` MessageSummary[], required
    - `id` string, required
    - `threadId` string, required
    - `mailbox` string, email, required
    - `folder` string, required
    - `direction` 'inbound' | 'outbound', required
    - `from` EmailAddress, required
      - `email` string, email, required
      - `name` string
    - `to` EmailAddress[], required
      - `email` string, email, required
      - `name` string
    - `cc` EmailAddress[]
      - `email` string, email, required
      - `name` string
    - `subject` string, required
    - `snippet` string, required
    - `bodyText` string, required
    - `date` string, date-time, required
    - `read` boolean, required
    - `headerMessageId` string: RFC 5322 Message-ID.
  - `count` integer, required

## Other responses

- `401`: Missing, invalid or revoked API key.
- `403`: The key lacks the scope (`missing_scope`) or the access (`forbidden`).
- `404`: Not found — or not reachable with this key.
- `429`: Too many requests.

---

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