---
title: "Get Conversations History"
method: GET
path: "/api/chat/history"
tags: ["Chat"]
---

# Get Conversations History

`GET /api/chat/history`

Get Conversation history.

## Query parameters

- `bot_id` string, uuid, required
- `date_from` string, date-time — Start date for filtering chat history.
- `date_to` string, date-time — End date for filtering chat history.
- `order` string, nullable — Ordering of chat history. Format: '<field_name>.<direction>'.

## Response `200`

Successful Response

- ChatHistoryResponseSchema[]
  - `bot_name` string, nullable — Optional name of the associated bot.
  - `bot_id` string, uuid, required — Unique identifier for the associated bot.
  - `user_id` string, uuid, required — Unique identifier for the user.
  - `session_id` string, required — Identifier for the conversation session.
  - `created_at` string, date-time, required — Timestamp indicating when the conversation history was created.
  - `chat_history_response` ChatHistorySchema[], required — List of chat history entries.
    - `sender_type` string, required — Type of the message sender.
    - `content` string, required — Content of the message.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/chat-fly/apis/chatfly-backend-application.md) · [All operations](https://skmtc.net/chat-fly/apis/chatfly-backend-application/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chat-fly/chatfly-backend-application/revisions/cbb37496f138/schema)