---
title: "List agent conversations"
method: GET
path: "/public/v1/agents/{agentId}/conversations"
tags: ["Agents"]
---

# List agent conversations

`GET /public/v1/agents/{agentId}/conversations`

Lists conversations for an agent, including the latest rolling summary and linked CRM contact. Supports full-text search (`search`), channel and feedback filters, and date ranges. Requires a USER API key.

## Path parameters

- `agentId` string, required

## Query parameters

- `is_closed` 'true' | 'false'
- `start_date` string, nullable
- `end_date` string, nullable
- `search` string — Full-text search over message content and conversation name.
- `channels` string — Comma-separated channels to filter by. Valid values: LIVE_CHAT, SHARED, OVERVIEW, API, WHATSAPP, INSTAGRAM, MESSENGER, SLACK, MAX_EXTENSION, MAX_WEB, MAX_API.
- `feedback` 'POSITIVE' | 'NEGATIVE' — Only conversations containing a message with this feedback rating. Valid values: POSITIVE, NEGATIVE.

## Response `200`

A list of conversations

- object — Standard list response
  - `results` PublicConversation[], required
    - `id` number, required
    - `name` string, nullable
    - `channel` string, required
    - `is_closed` boolean, required
    - `contact_id` string, nullable
    - `summary` string, nullable — Latest rolling summary of the conversation, if one has been generated.
    - `contact` object, nullable — The linked CRM contact (People record), if any.
    - `created_at` string, required
    - `updated_at` string, nullable

---

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