---
title: "Get chat history"
method: GET
path: "/{scope_id}/chats/{conversation_id}/history"
---

# Get chat history

`GET /{scope_id}/chats/{conversation_id}/history`

The method allows you to get a list of messages in a specific chat.

## Path parameters

- `scope_id` string, required
- `conversation_id` string, required

## Query parameters

- `offset` integer
- `limit` integer

## Headers

- `Date` string, required
- `Content-type` string, required
- `Content-MD5` string
- `X-Signature` string

## Response `200`

200

- object
  - `messages` object[]
    - `timestamp` integer
    - `msec_timestamp` integer
    - `sender` object
      - `id` string
      - `name` string
      - `avatar` string
    - `receiver` object
      - `id` string
      - `client_id` string
      - `name` string
      - `avatar` string
      - `phone` string
    - `message` object
      - `id` string
      - `type` string
      - `text` string
      - `media` string
      - `thumbnail` string
      - `file_name` string
      - `file_size` integer

## Other responses

- `204` — 204
- `400` — 400
- `403` — 403

---

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