---
title: "List Chats"
method: GET
path: "/agent/chats/list"
tags: ["accepts-api-key"]
---

# List Chats

`GET /agent/chats/list`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/agent/chats/list`
- Auth: none declared

## Query parameters

- `limit` integer
- `offset` integer
- `before` string, date-time, nullable
- `after` string, date-time, nullable

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- ChatHistoryResponse[]
  - `id` string, required
  - `name` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `custom_agent_id` string, nullable, required
  - `total_tokens` number, required
  - `is_running` boolean, required
  - `last_read_at` string, date-time, nullable: The `created_at` of the newest message the caller has read in this chat. Null when the caller has never read it; such a chat counts as read.
  - `is_unread` boolean: Whether the agent has written a message newer than `last_read_at`. The caller's own messages never make a chat unread. Reading the newest page of `GET /chat/{chat_id}/messages` or calling `POST /chat/{chat_id}/read` clears it.
  - `can_write` boolean: Whether the caller may send messages in the chat, rename it or delete it. False when the chat was only shared with them to view.
  - `parent_chat_id` string, nullable: For a sub-chat, the main chat that started it; null for a main chat. Sub-chats are not in `GET /chats/list`: list them with `GET /chat/{chat_id}/sub_chats` on their main chat.
  - `sub_chat_index` integer, nullable: For a sub-chat started from a CSV, the row it works on (0 = first row under the header); null otherwise.
  - `sub_chat_count` integer: How many sub-chats this chat has started.
  - `running_sub_chat_count` integer: How many of this chat's sub-chats are running now.

## Other responses

- `422`: Validation Error

---

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