---
title: "Get chat history"
method: GET
path: "/bot/getChatHistory"
tags: ["Bot"]
---

# Get chat history

`GET /bot/getChatHistory`

Returns a page of messages from a private conversation or chat. Supply exactly one of user_id or chat_id, and use offset_message_id to request older messages.

## Query parameters

- `user_id` string — A positive decimal Inline user identifier
- `chat_id` string — A positive decimal Inline chat identifier
- `limit` string — A signed decimal integer string within JavaScript's safe-integer range
- `offset_message_id` string — A positive decimal Inline message identifier

## Headers

- `authorization` string, required

## Response `200`

Successful getChatHistory response.

- BotGetChatHistorySuccess — unresolved $ref

## Other responses

- `400` — The request parameters are missing or invalid.
- `401` — The bot token is missing or invalid.
- `403` — The bot is not allowed to perform this action.
- `404` — The requested method or resource was not found.
- `500` — The server could not complete the request.

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-26** `d80f3b8927b8` — 22 breaking, 5 warning, 24 info
  - the `header` request parameter `authorization` became required
  - removed the media type `multipart/form-data` for the response with the status `200`
  - removed the media type `multipart/form-data` for the response with the status `400`
  - removed the media type `multipart/form-data` for the response with the status `401`
  - …47 more

[Change history](https://skmtc.dev/inline/apis/inline-bot-http-api-docs/changes/bot/getChatHistory/get.md)

---

[API](https://skmtc.dev/inline/apis/inline-bot-http-api-docs.md) · [All operations](https://skmtc.dev/inline/apis/inline-bot-http-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inline/inline-bot-http-api-docs/revisions/69017b8dc5fe/schema)