/conversations.list
GET
/conversations.list
conversations
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://slack.com/api/conversations.list'
Response Response Example
200 - response
{
"channels": [
{
"created": 1449252889,
"creator": "U012A3CDE",
"id": "C012AB3CD",
"is_archived": false,
"is_channel": true,
"is_ext_shared": false,
"is_general": true,
"is_group": false,
"is_im": false,
"is_member": true,
"is_mpim": false,
"is_org_shared": false,
"is_pending_ext_shared": false,
"is_private": false,
"is_shared": false,
"name": "general",
"name_normalized": "general",
"num_members": 4,
"pending_shared": [],
"previous_names": [],
"purpose": {
"creator": "",
"last_set": 0,
"value": "This channel is for team-wide communication and announcements. All team members are in this channel."
},
"topic": {
"creator": "",
"last_set": 0,
"value": "Company-wide announcements and work-based matters"
},
"unlinked": 0
},
{
"created": 1449252889,
"creator": "U061F7AUR",
"id": "C061EG9T2",
"is_archived": false,
"is_channel": true,
"is_ext_shared": false,
"is_general": false,
"is_group": false,
"is_im": false,
"is_member": true,
"is_mpim": false,
"is_org_shared": false,
"is_pending_ext_shared": false,
"is_private": false,
"is_shared": false,
"name": "random",
"name_normalized": "random",
"num_members": 4,
"pending_shared": [],
"previous_names": [],
"purpose": {
"creator": "",
"last_set": 0,
"value": "A place for non-work-related flimflam, faffing, hodge-podge or jibber-jabber you'd prefer to keep out of more focused work-related channels."
},
"topic": {
"creator": "",
"last_set": 0,
"value": "Non-work banter and water cooler conversation"
},
"unlinked": 0
}
],
"ok": true,
"response_metadata": {
"next_cursor": "dGVhbTpDMDYxRkE1UEI="
}
}
Request
Query Params
token
stringÂ
optional
conversations:read
exclude_archived
stringÂ
optional
true
to exclude archived channels from the listtypes
stringÂ
optional
public_channel
, private_channel
, mpim
, im
limit
integerÂ
optional
cursor
stringÂ
optional
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.Responses
Modified at 2023-08-15 05:39:45