---
title: "List Messages"
method: GET
path: "/v1/messages"
---

# List Messages

`GET /v1/messages`

List organization-visible messages from native or custom sources.

Requires the **Export** permission (`read` scope). Private messages owned by
individual users are excluded. Results use cursor-based pagination.

## Query parameters

- `sourceId` string, nullable
- `remoteId` string, nullable
- `threadId` string, nullable
- `participantEmail` string, nullable
- `createdAfter` string, nullable
- `createdBefore` string, nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- ListMessagesResponse — Paginated list response. Cursor-based pagination.
  - `messages` MessageListItem[], required
    - `messageId` string, uuid, required
    - `sourceId` string, required
    - `remoteId` string, nullable, required
    - `threadId` string, nullable, required
    - `subject` string, nullable
    - `sender` MessageParty, required — A message participant — sender or one of the recipients.
      - `name` string, nullable
      - `email` string, nullable
    - `recipients` MessageParty[], required
      - `name` string, nullable
      - `email` string, nullable
    - `bodyPreview` string, required
    - `createdAt` string, date-time, required
  - `pagination` PaginationInfo, required — Cursor-based pagination metadata returned alongside list responses. All public-API list endpoints emit the same shape: pass ``next_cursor`` back as the ``cursor`` query parameter to fetch the next page; check ``has_more`` to know whether more pages exist.
    - `nextCursor` string, nullable
    - `hasMore` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sybill/apis/sybill-api.md) · [All operations](https://skmtc.net/sybill/apis/sybill-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sybill/sybill-api/revisions/f499ec011b17/schema)