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

# Get chat history

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

## Request

- Base URL: `https://amojo.kommo.com/v2/origin/custom`
- URL: `https://amojo.kommo.com/v2/origin/custom/{scope_id}/chats/{conversation_id}/history`
- Auth: none required

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.dev/kommo/apis/chats-api.md) - [All operations](https://skmtc.dev/kommo/apis/chats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/chats-api/revisions/174554fdf536?raw)