Fetches a conversation’s history of messages and events.
| |
|---|
| Surface | web-api |
| Rate limit | Tier 3 (50/min) |
| Argument | Required | Type | |
|---|
channel | no | string | Conversation ID to fetch history for. |
latest | no | number | End of time range of messages to include in results. |
oldest | no | number | Start of time range of messages to include in results. |
inclusive | no | boolean | Include messages with latest or oldest timestamp in results only when either timestamp is specified. |
limit | no | integer | The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the users list hasn’t been reached. |
cursor | no | string | Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request’s response_metadata. Default value fetches the first “page” of the collection. See pagination for more detail. |
ok is always present (true, or false with error). Additional fields:
| Field | Type | |
|---|
channel_actions_count | integer | |
channel_actions_ts | object | |
has_more | boolean | |
messages | object[] | |
pin_count | integer | |
Works with every official Slack SDK — call it exactly as you would against Slack.
| |
|---|
| Source spec | Slack Web API OpenAPI v1.7.0 (apis.guru OAS3 conversion of slackapi/slack-api-specs, upstream archived 2024-03) |
| Retrieved / verified | 2026-06-04 · patches applied: 0 |
| In frozen spec | yes — fields below are copied from the published spec |
| Conformance | exercised by unmodified official SDKs on every release |
| See also | Slack’s conversations.history reference |