---
title: "Lists all public and private channels in a Slack workspace."
method: POST
path: "/listChannelInfos"
tags: ["channel"]
---

# Lists all public and private channels in a Slack workspace.

`POST /listChannelInfos`

Retrieves detailed information about all public and private channels in a Slack workspace ( only use this when you need to get full details of a channel ).

## Request body

- object
  - `body` object — Body of the getChannels sls call
    - `arguments` object, required — Container for function arguments.
      - `cursor` string — A cursor to the next page of results.
      - `limit` number — The maximum number of channels to return. Defaults to 50.

## Response `200`

Successful response containing an array of conversation objects

- object
  - `channels` object[]
    - `id` string, required — The ID of the conversation
    - `name` string, required — The name of the channel-like thing, without a leading hash sign
    - `is_channel` boolean, required — Indicates whether a conversation is a channel
    - `is_group` boolean — Means the channel is a private channel created before March 2021
    - `is_im` boolean — Means the conversation is a direct message between two individuals or a user and a bot
    - `is_mpim` boolean — Represents an unnamed private conversation between multiple users
    - `is_private` boolean — Means the conversation is privileged between two or more members
    - `created` integer — Timestamp of when the conversation was created
    - `creator` string — The ID of the member that created this conversation
    - `is_archived` boolean — Indicates a conversation is archived
    - `is_general` boolean — Means the channel is the workspace's 'general' discussion channel
    - `unlinked` integer
    - `name_normalized` string — The 'normalized' name of a channel
    - `is_shared` boolean — Means the conversation is shared between multiple workspaces
    - `is_frozen` boolean — Indicates that the channel is frozen
    - `is_org_shared` boolean — Indicates whether this shared channel is shared between Enterprise Grid workspaces within the same organization
    - `is_pending_ext_shared` boolean — Means the conversation is ready to become an is_ext_shared channel, but needs approval
    - `pending_shared` string[] — A list of team IDs that have been invited to the channel but have not yet joined
    - `context_team_id` string — The team ID of the team that this channel belongs to
    - `updated` integer — The timestamp, in milliseconds, when the channel settings were updated
    - `parent_conversation` string — The ID of the parent conversation for threaded messages
    - `is_ext_shared` boolean — Indicates whether a conversation is part of a Shared Channel with a remote organization
    - `shared_team_ids` string[] — A list of team IDs that are part of this shared channel
    - `pending_connected_team_ids` string[] — A list of team IDs that have been invited to connect to the channel but have not yet accepted
    - `is_member` boolean — Indicates whether the user, bot user or Slack app associated with the token making the API call is itself a member of the conversation
    - `topic` object — Provides information about the channel topic
      - `value` string
      - `creator` string
      - `last_set` integer
    - `purpose` object — Provides information about the channel purpose
      - `value` string
      - `creator` string
      - `last_set` integer
    - `previous_names` string[] — A list of previous names for the channel
    - `num_members` integer — The number of members in the conversation
    - `locale` string — The locale for this conversation
    - `last_read` integer — The timestamp for the last message the calling user has read in this channel
    - `latest` string — The latest message in the channel
    - `unread_count` integer — A full count of visible messages that the calling user has yet to read
    - `unread_count_display` integer — A count of messages that the calling user has yet to read that matter to them

## Other responses

- `400` — Bad Request - The request was invalid or cannot be served
- `500` — Internal Server Error - The server has encountered a situation it doesn't know how to handle

---

[API](https://skmtc.net/microfox-ai/apis/slack-d.md) · [All operations](https://skmtc.net/microfox-ai/apis/slack-d/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/microfox-ai/slack-d/versions/cd0edf0c2cdf/schema)