Sample - Slack Web API
GET/conversations.replies

Get messages in a conversation thread

Retrieves the messages in a conversation thread. Use channel and the parent message timestamp in ts to identify the thread, and use time bounds, limit, or cursor to control the returned messages.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

8 parameters
tokenstringoptional
Authentication token for the request; it must provide the `conversations:history` scope.
channelstringoptional
The ID of the conversation containing the thread.
tsnumberoptional
The numeric timestamp of the thread's parent message; if it has no replies, the parent message is returned.
latestnumberoptional
The numeric timestamp marking the end of the message time range.
oldestnumberoptional
The numeric timestamp marking the start of the message time range.
inclusivebooleanoptional
Set to true to include messages whose timestamps equal `latest` or `oldest` when those bounds are supplied.
limitintegeroptional
Maximum number of messages to return; fewer may be returned even when more messages remain.
cursorstringoptional
Pagination cursor from a previous response's `response_metadata.next_cursor`; omit it to retrieve the first page.

2 status codes
200Returns a response containing a `messages` array, an `ok` value of true, and a `has_more` indicator.
has_morebooleanoptional
messagesarray<array>required
okbooleanrequired
Allowed:true
defaultTypical error response
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:missing_scopechannel_not_foundthread_not_foundnot_authedinvalid_authaccount_inactiveinvalid_arg_nameinvalid_array_arginvalid_charsetinvalid_form_datainvalid_post_typemissing_post_type
neededstringoptional
okbooleanrequired
Allowed:false
providedstringoptional

Error handling

channel must identify the conversation and ts must be the numeric timestamp of an existing message that can serve as the thread parent. Use cursor from a previous response to continue pagination, and provide a token with the conversations:history scope when authentication is required.