---
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

## Changes

> 3 revisions in range; 1 not diffed.

- **2023-11-13** `ac1f1ab68fcb` — 4 info
  - the endpoint scheme security `OAuth2PasswordBearerCookie` was added to the API
  - the endpoint scheme security `BasicAuth` was removed from the API
  - added the non-success response with the status `422`
  - added the success response with the status `200`
- **2023-11-08** `dbd91277da05` — 1 breaking, 4 info
  - removed the success response with the status `200`
  - the endpoint scheme security `BasicAuth` was added to the API
  - the endpoint scheme security `APIKeyAuth` was removed from the API
  - the endpoint scheme security `OAuth2PasswordBearerCookie` was removed from the API
  - …1 more

[Change history](https://skmtc.dev/chat-fly/apis/chatfly-backend-application/changes/api/chat/history/get.md)

---

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