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

---

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