---
title: "Get paginated list of conversations"
method: GET
path: "/internal/api/chat/conversations"
tags: ["CHAT"]
---

# Get paginated list of conversations

`GET /internal/api/chat/conversations`

## Request

- Base URL: `https://api.signalshq.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.signalshq.io/internal/api/chat/conversations`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

Retrieve conversations with message previews, pagination, and sorting support across all types.

## Query parameters

- `page` integer: Page number (1-based)
- `limit` integer: Number of conversations per page
- `sort_by` string: Sort field: updated_at, created_at
- `order` string: Sort order: asc, desc
- `conversation_type` 'TAX_RESEARCH' | 'STATE_TAX_RESEARCH' | 'GENERAL' | 'INVOICE_HELP' | 'TEMPLATE_HELP'
- `is_bookmarked` boolean, nullable: Filter by bookmark: true/false/omit=all

## Response `200`

Successful Response

- ConversationListResponse: Response model for the conversations listing API.
  - `status` string, required
  - `page` integer, required
  - `limit` integer, required
  - `total_conversations` integer, required
  - `total_pages` integer, required
  - `conversations` ConversationSummary[], required
    - `conversation_id` string, uuid, required
    - `conversation_type` 'TAX_RESEARCH' | 'STATE_TAX_RESEARCH' | 'GENERAL' | 'INVOICE_HELP' | 'TEMPLATE_HELP', required
    - `created_at` string, date-time, required
    - `last_updated_at` string, date-time, required
    - `message_count` integer, required
    - `last_user_message_preview` string, nullable
    - `last_response_preview` string, nullable
    - `status` 'ACTIVE' | 'ARCHIVED' | 'DELETED', required
    - `is_bookmarked` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/signalshq/apis/signals-api.md) - [All operations](https://skmtc.dev/signalshq/apis/signals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalshq/apis/signals-api/revisions/2c22af3b5576?raw)