---
title: "List Max conversations"
method: GET
path: "/public/v1/max/conversations"
tags: ["Max Conversations"]
---

# List Max conversations

`GET /public/v1/max/conversations`

Returns the calling user's chat threads with Max, newest activity first, each with a short preview instead of the full message history. Requires a USER API key.

## Query parameters

- `fromDate` string, nullable
- `toDate` string, nullable
- `isClosed` union
  - boolean
  - string
- `isArchived` union
  - boolean
  - string
- `pinned` union
  - boolean
  - string
- `channels` string[], nullable
- `text` string

## Response `200`

Paginated conversations

- object
  - `ok` true, required
  - `data` PublicMaxConversationList, required
    - `results` PublicMaxConversation[], required
      - `id` number, required
      - `name` string, nullable
      - `max_agent_id` number, nullable
      - `channel` string, nullable
      - `is_closed` boolean, nullable
      - `is_archived` boolean, nullable
      - `is_pinned` boolean, nullable
      - `created_at` string, nullable
      - `updated_at` string, nullable
      - `last_message_at` string, nullable
      - `last_message_preview` string, nullable
      - `messages` object[]
      - `current_plan` object, nullable
      - `questions` object[]
      - `message_abort_key` string, nullable
    - `total` number, required
    - `page_size` number, required
    - `page_num` number, required
    - `total_pages` number, required

## Other responses

- `401` — Unauthorized — a USER API key is required

## Changes

- **2026-10-03** `666cd9efa9f3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getfrontline/apis/public-api/changes/public/v1/max/conversations/get.md)

---

[API](https://skmtc.dev/getfrontline/apis/public-api.md) · [All operations](https://skmtc.dev/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getfrontline/apis/public-api/revisions/666cd9efa9f3?raw)