---
title: "List Conversations"
method: GET
path: "/api/v1/chat-ai/conversations"
tags: ["chat-ai", "conversations"]
---

# List Conversations

`GET /api/v1/chat-ai/conversations`

List conversations for the authenticated user with pagination.

`search` narrows by title. It belongs here rather than in the client
because the sidebar is how a conversation is found: filtering the page the
client happens to hold would report "no match" about history it never
fetched. `total` narrows with it, so a caller can still tell a complete
answer from a truncated one.

## Query parameters

- `page` integer
- `per_page` integer
- `search` string, nullable — Match conversation titles, case-insensitively, anywhere in the title.

## Response `200`

Successful Response

- ConversationListResponse — Paginated conversation list response.
  - `items` ConversationRead[], required
    - `id` string, uuid, required
    - `tenant_id` string, uuid, required
    - `user_id` string, uuid, nullable
    - `chat_agent_id` string, uuid, required
    - `property_id` string, uuid, nullable
    - `action_item_id` string, uuid, nullable
    - `title` string, nullable, required
    - `preview` string, nullable, required
    - `last_message_at` string, date-time, nullable, required
    - `message_count` integer, required
    - `langgraph_thread_id` string, nullable, required
    - `investigation_context` string, nullable
    - `channel` string
    - `external_conversation_id` string, nullable
    - `external_thread_key` string, nullable
    - `integration_connection_id` string, uuid, nullable
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-15** `41c5e4645524` — 1 info
  - added the optional property `items/items/action_item_id` to the response with the `200` status
- **2026-09-09** `7a2140816370` — 1 info
  - added the new optional `query` request parameter `search`
- **2026-09-09** `14d0341c60b5` — 2 breaking, 4 info
  - the response property `items/items/user_id` became optional for the status `200`
  - response property `items/items/user_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the optional property `items/items/channel` to the response with the `200` status
  - added the optional property `items/items/external_conversation_id` to the response with the `200` status
  - …2 more
- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/chat-ai/conversations/get.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/41c5e4645524?raw)