---
title: "Fetches a conversation's history of messages and events."
method: POST
path: "/getConversationHistory"
tags: ["channel", "message"]
---

# Fetches a conversation's history of messages and events.

`POST /getConversationHistory`

Fetches a conversation's history of messages and events from a specific channel.

## Request body

- object
  - `body` object — Body of the getConversationHistory sls call
    - `arguments` object, required
      - `channelId` string, required — The ID of the channel to fetch history for. Channel IDs start with 'C'.
      - `limit` integer — The maximum number of items to return.
      - `latest` string — End of the time range of messages to include in results.
      - `oldest` string — Start of the time range of messages to include in results.
      - `inclusive` boolean — Include messages with latest or oldest timestamps in results.
      - `cursor` string — Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata.

## Response `200`

Successful response

- object
  - `messages` object[]
    - `type` string
    - `user` string
    - `text` string
    - `ts` string
  - `nextCursor` string

## Other responses

- `400` — Bad Request - The server cannot process the request due to a client error.
- `500` — Internal Server Error - The server encountered an unexpected condition that prevented it from fulfilling the request.

## Changes

> 45 revisions in range; 1 could not be searched.

- **2025-07-18** `8d0d784763dc` — 1 breaking, 2 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the optional property `messages` to the response with the `200` status
  - added the optional property `nextCursor` to the response with the `200` status
- **2025-07-16** `6a2873d28ea3` — 1 info
  - endpoint added
- **2025-06-20** `37c50ff8be3a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/microfox-ai/apis/slack-d/changes/getConversationHistory/post.md)

---

[API](https://skmtc.dev/microfox-ai/apis/slack-d.md) · [All operations](https://skmtc.dev/microfox-ai/apis/slack-d/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microfox-ai/slack-d/revisions/cd0edf0c2cdf/schema)