Sample - Slack Web API
GET/conversations.list

List conversations

Lists conversations in a Slack team, optionally filtering by archive state and conversation type. Use types to select public, private, multi-person direct, or direct conversations, and use cursor to retrieve subsequent pages.

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

5 parameters
tokenstringoptional
Authentication token for the request; it must provide the `conversations:read` scope.
exclude_archivedbooleanoptional
Set to true to exclude archived conversations from the results.
typesstringoptional
Comma-separated conversation types: `public_channel`, `private_channel`, `mpim`, or `im`.
limitintegeroptional
Maximum number of conversations to return; it must be an integer no larger than 1000.
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 unique `channels` array, an `ok` value of true, and `response_metadata.next_cursor` for pagination.
channelsarray<array>required
okbooleanrequired
Allowed:true
response_metadataobjectoptional
defaultTypical error response
callstackstringoptional
Note: PHP callstack is only visible in dev/qa
errorstringrequired
Allowed:missing_scopenot_authedinvalid_authaccount_inactiveinvalid_arg_nameinvalid_array_arginvalid_charsetinvalid_form_datainvalid_post_typemissing_post_typeinvalid_jsonjson_not_object
neededstringoptional
okbooleanrequired
Allowed:false
providedstringoptional

Error handling

The limit value must be an integer no larger than 1000, and types must be a comma-separated list of supported conversation types when provided. Pass the cursor from response_metadata.next_cursor to continue pagination, and use a token with the conversations:read scope.