--- title: "GET /conversations.history" method: GET path: "/conversations.history" tags: ["conversations"] --- # GET /conversations.history `GET /conversations.history` Fetches a conversation's history of messages and events. ## Query parameters - `token` string - `channel` string - `latest` number - `oldest` number - `inclusive` boolean - `limit` integer - `cursor` string ## Response `200` Typical success response containing a channel's messages - object — Schema for successful response from conversations.history method - `channel_actions_count` integer, required - `channel_actions_ts` union[], required - union - integer - unknown - `has_more` boolean, required - `messages` ObjsMessage[], required - `attachments` object[] - `fallback` string - `id` integer, required - `image_bytes` integer - `image_height` integer - `image_url` string - `image_width` integer - `blocks` object[] — This is a very loose definition, in the future, we'll populate this with deeper schema in this definition namespace. - `type` string, required - `bot_id` union[] - union - string - unknown - `bot_profile` ObjsBotProfile - `app_id` string, required - `deleted` boolean, required - `icons` object, required - `image_36` string, uri, required - `image_48` string, uri, required - `image_72` string, uri, required - `id` string, required - `name` string, required - `team_id` string, required - `updated` integer, required - `client_msg_id` string - `comment` ObjsComment - `comment` string, required - `created` integer, required - `id` string, required - `is_intro` boolean, required - `is_starred` boolean - `num_stars` integer - `pinned_info` DefsPinnedInfo - `pinned_to` DefsChannel[] - `reactions` ObjsReaction[] - `count` integer, required - `name` string, required - `users` DefsUserId[], required - `timestamp` integer, required - `user` string, required - `display_as_bot` boolean - `file` ObjsFile - `channels` DefsChannelId[] - `comments_count` integer - `created` integer - `date_delete` integer - `display_as_bot` boolean - `editable` boolean - `editor` string - `external_id` string - `external_type` string - `external_url` string, uri - `filetype` string - `groups` DefsGroupId[] - `has_rich_preview` boolean - `id` string - `image_exif_rotation` integer - `ims` DefsDmId[] - `is_external` boolean - `is_public` boolean - `is_starred` boolean - `is_tombstoned` boolean - `last_editor` string - `mimetype` string - `mode` string - `name` string - `non_owner_editable` boolean - `num_stars` integer - `original_h` integer - `original_w` integer - `permalink` string, uri - `permalink_public` string, uri - `pinned_info` DefsPinnedInfo - `pinned_to` DefsChannel[] - `pretty_type` string - `preview` string - `public_url_shared` boolean - `reactions` ObjsReaction[] - `count` integer, required - `name` string, required - `users` DefsUserId[], required - `shares` object - `private` unknown - `public` unknown - `size` integer - `source_team` string - `state` string - `thumb_1024` string, uri - `thumb_1024_h` integer - `thumb_1024_w` integer - `thumb_160` string, uri - `thumb_360` string, uri - `thumb_360_h` integer - `thumb_360_w` integer - `thumb_480` string, uri - `thumb_480_h` integer - `thumb_480_w` integer - `thumb_64` string, uri - `thumb_720` string, uri - `thumb_720_h` integer - `thumb_720_w` integer - `thumb_80` string, uri - `thumb_800` string, uri - `thumb_800_h` integer - `thumb_800_w` integer - `thumb_960` string, uri - `thumb_960_h` integer - `thumb_960_w` integer - `thumb_tiny` string - `timestamp` integer - `title` string - `updated` integer - `url_private` string, uri - `url_private_download` string, uri - `user` string - `user_team` string - `username` string - `files` ObjsFile[] - `channels` DefsChannelId[] - `comments_count` integer - `created` integer - `date_delete` integer - `display_as_bot` boolean - `editable` boolean - `editor` string - `external_id` string - `external_type` string - `external_url` string, uri - `filetype` string - `groups` DefsGroupId[] - `has_rich_preview` boolean - `id` string - `image_exif_rotation` integer - `ims` DefsDmId[] - `is_external` boolean - `is_public` boolean - `is_starred` boolean - `is_tombstoned` boolean - `last_editor` string - `mimetype` string - `mode` string - `name` string - `non_owner_editable` boolean - `num_stars` integer - `original_h` integer - `original_w` integer - `permalink` string, uri - `permalink_public` string, uri - `pinned_info` DefsPinnedInfo - `pinned_to` DefsChannel[] - `pretty_type` string - `preview` string - `public_url_shared` boolean - `reactions` ObjsReaction[] - `count` integer, required - `name` string, required - `users` DefsUserId[], required - `shares` object - `private` unknown - `public` unknown - `size` integer - `source_team` string - `state` string - `thumb_1024` string, uri - `thumb_1024_h` integer - `thumb_1024_w` integer - `thumb_160` string, uri - `thumb_360` string, uri - `thumb_360_h` integer - `thumb_360_w` integer - `thumb_480` string, uri - `thumb_480_h` integer - `thumb_480_w` integer - `thumb_64` string, uri - `thumb_720` string, uri - `thumb_720_h` integer - `thumb_720_w` integer - `thumb_80` string, uri - `thumb_800` string, uri - `thumb_800_h` integer - `thumb_800_w` integer - `thumb_960` string, uri - `thumb_960_h` integer - `thumb_960_w` integer - `thumb_tiny` string - `timestamp` integer - `title` string - `updated` integer - `url_private` string, uri - `url_private_download` string, uri - `user` string - `user_team` string - `username` string - `icons` object - `emoji` string - `image_64` string, uri - `inviter` string - `is_delayed_message` boolean - `is_intro` boolean - `is_starred` boolean - `last_read` string - `latest_reply` string - `name` string - `old_name` string - `parent_user_id` string - `permalink` string, uri - `pinned_to` DefsChannel[] - `purpose` string - `reactions` ObjsReaction[] - `count` integer, required - `name` string, required - `users` DefsUserId[], required - `reply_count` integer - `reply_users` DefsUserId[] - `reply_users_count` integer - `source_team` string - `subscribed` boolean - `subtype` string - `team` string - `text` string, required - `thread_ts` string - `topic` string - `ts` string, required - `type` string, required - `unread_count` integer - `upload` boolean - `user` string - `user_profile` ObjsUserProfileShort - `avatar_hash` string, required - `display_name` string, required - `display_name_normalized` string - `first_name` string, nullable, required - `image_72` string, uri, required - `is_restricted` boolean, required - `is_ultra_restricted` boolean, required - `name` string, required - `real_name` string, required - `real_name_normalized` string - `team` string, required - `user_team` string - `username` string - `ok` true, required - `pin_count` integer, required ## Other responses - `default` — Typical error response --- [API](https://skmtc.net/slack/apis/web-api.md) · [All operations](https://skmtc.net/slack/apis/web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slack/web-api/revisions/7b951462b44f/schema)