---
title: "List Chats"
method: GET
path: "/v1/chats"
tags: ["Chats"]
---

# List Chats

`GET /v1/chats`

Returns a paginated list of chat sessions for the account, sorted by most recently created first. Use the status parameter to filter by session state. Use page and size to navigate through results.

## Query parameters

- `status` string
- `page` integer
- `size` integer

## Response `200`

OK

- PaginatedResponseChatResponse — Standard wrapper for paginated API responses. Use this when returning list data that is split across multiple pages. Includes the current page of results along with pagination metadata to help clients navigate through large datasets efficiently.
  - `data` ChatResponse[] — List of items for the current page. Contains up to 'size' number of records.
    - `chatId` string — Unique identity for a chat
    - `agent` AgentResponse — Agent assigned to handle all calls in this campaign. Contains the agent's ID, name, and current status. All contacts in the campaign's contact list will be called using this agent.
      - `name` string — The display name of the assigned agent.
      - `agentId` string — The unique identifier of the agent within the system.
      - `status` 'Live' | 'Testing' | 'Disabled' — The current operational status of the agent.
    - `createdAt` string, date-time — The timestamp when the call record was created.
    - `status` string — Status of chat
    - `transcript` string — transcript of the conversation in chat
    - `response` ChatMessage[] — Agent response of the last user message
      - `id` string — Unique identity for a chat message
      - `role` 'user' | 'assistant' — Role of the chat message
      - `type` 'message' — Type of the chat message
      - `content` string[] — Chat message content
    - `messages` ChatMessage[] — Agent response of the last user message
      - `id` string — Unique identity for a chat message
      - `role` 'user' | 'assistant' — Role of the chat message
      - `type` 'message' — Type of the chat message
      - `content` string[] — Chat message content
    - `dynamicVariables` JsonNode — Dynamic key-value pairs that were passed to the agent at call start for personalisation. Keys correspond to variable names defined in the agent's configuration (e.g., 'customer_name', 'account_id'). Null or empty if no dynamic variables were provided when the call was created.
  - `page` integer — Current page number (0-based index). Indicates which page of results is being returned.
  - `size` integer — Number of items requested per page. Determines the maximum size of the 'data' list.
  - `totalCount` integer — Total number of records available across all pages. Useful for calculating pagination on the client side.
  - `totalPages` integer — Total number of pages available based on totalCounts and size. Helps clients understand how many pages exist in total.
  - `hasNext` boolean — Indicates whether there is a next page available after the current one. Useful for implementing 'Load More' or next navigation.
  - `hasPrevious` boolean — Indicates whether there is a previous page before the current one. Useful for enabling backward navigation.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/sigmamind/apis/sigmamind-apis.md) · [All operations](https://skmtc.net/sigmamind/apis/sigmamind-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sigmamind/sigmamind-apis/versions/d00f52b5123f/schema)