---
title: "List turns in a chat"
method: GET
path: "/v2/chats/{chat_id}/turns"
tags: ["Chats"]
deprecated: true
---

# List turns in a chat

`GET /v2/chats/{chat_id}/turns`

> **Deprecated.**

Lists all turns in a chat. Each turn is a message and response pair in the dialog.

## Path parameters

- `chat_id` string, required

## Headers

- `Request-Timeout` integer
- `Request-Timeout-Millis` integer

## Response `200`

List of turns.

- ListChatTurnsResponse — Response containing a list of turns (message exchanges) within a chat conversation.
  - `turns` Turn[] — List of turns.
    - `id` string, required — The ID of the turn.
    - `chat_id` string — The ID of the chat the turn resides in.
    - `query` string — The query made to produce this turn.
    - `answer` string — The response to the query.
    - `enabled` boolean — Indicates whether the turn is enabled and shown in future turns of the chat.
    - `created_at` string, date-time — Specifies when the turn was created.

## Other responses

- `403` — Permissions do not allow listing turns in the chat.
- `404` — Corpus or chat not found.

---

[API](https://skmtc.net/vectara/apis/vectara-rest-api-v2.md) · [All operations](https://skmtc.net/vectara/apis/vectara-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vectara/vectara-rest-api-v2/revisions/e85040b266cc/schema)