---
title: "GET /conversations.list"
method: GET
path: "/conversations.list"
tags: ["conversations"]
---

# GET /conversations.list

`GET /conversations.list`

Lists all channels in a Slack team.

## Query parameters

- `token` string
- `exclude_archived` boolean
- `types` string
- `limit` integer
- `cursor` string

## Response `200`

Typical success response with only public channels

- object — Schema for successful response from conversations.list method
  - `channels` ObjsConversation[], required
    - union[]
      - union
        - object
          - `accepted_user` string
          - `connected_team_ids` DefsWorkspaceId[]
          - `conversation_host_id` string
          - `created` integer, required
          - `creator` string, required
          - `display_counts` object
            - `display_counts` integer, required
            - `guest_counts` integer, required
          - `enterprise_id` string
          - `has_pins` boolean
          - `id` string, required
          - `internal_team_ids` DefsTeam[]
          - `is_archived` boolean, required
          - `is_channel` boolean, required
          - `is_ext_shared` boolean
          - `is_frozen` boolean
          - `is_general` boolean, required
          - `is_global_shared` boolean
          - `is_group` boolean, required
          - `is_im` boolean, required
          - `is_member` boolean
          - `is_moved` integer
          - `is_mpim` false, required
          - `is_non_threadable` boolean
          - `is_open` boolean
          - `is_org_default` boolean
          - `is_org_mandatory` boolean
          - `is_org_shared` boolean, required
          - `is_pending_ext_shared` boolean
          - `is_private` boolean, required
          - `is_read_only` boolean
          - `is_shared` boolean, required
          - `is_starred` boolean
          - `is_thread_only` boolean
          - `last_read` string
          - `latest` union[]
            - union
              - …
          - `members` DefsUserId[]
          - `name` string, required
          - `name_normalized` string, required
          - `num_members` integer
          - `parent_conversation` union[]
            - union
              - …
          - `pending_connected_team_ids` DefsTeam[]
          - `pending_shared` DefsTeam[]
          - `pin_count` integer
          - `previous_names` DefsChannelName[]
          - `priority` number
          - `purpose` object, required
            - `creator` string, required
            - `last_set` integer, required
            - `value` string, required
          - `shared_team_ids` DefsTeam[]
          - `shares` object[]
            - `accepted_user` string
            - `is_active` boolean, required
            - `team` ObjsTeam, required
              - …
            - `user` string, required
          - `timezone_count` integer
          - `topic` object, required
            - `creator` string, required
            - `last_set` integer, required
            - `value` string, required
          - `unlinked` integer
          - `unread_count` integer
          - `unread_count_display` integer
          - `use_case` string
          - `user` string
          - `version` integer
        - object
          - `accepted_user` string
          - `connected_team_ids` DefsTeam[]
          - `conversation_host_id` string
          - `created` integer, required
          - `creator` string, required
          - `display_counts` object
            - `display_counts` integer, required
            - `guest_counts` integer, required
          - `id` string, required
          - `internal_team_ids` DefsTeam[]
          - `is_archived` boolean, required
          - `is_channel` boolean, required
          - `is_ext_shared` boolean
          - `is_frozen` boolean
          - `is_general` boolean, required
          - `is_group` boolean, required
          - `is_im` boolean, required
          - `is_member` boolean
          - `is_moved` integer
          - `is_mpim` true, required
          - `is_non_threadable` boolean
          - `is_open` boolean
          - `is_org_shared` boolean, required
          - `is_pending_ext_shared` boolean
          - `is_private` boolean, required
          - `is_read_only` boolean
          - `is_shared` boolean, required
          - `is_starred` boolean
          - `is_thread_only` boolean
          - `last_read` string
          - `latest` union[]
            - union
              - …
          - `members` DefsUserId[]
          - `name` string, required
          - `name_normalized` string, required
          - `num_members` integer
          - `parent_conversation` union[]
            - union
              - …
          - `pending_connected_team_ids` DefsTeam[]
          - `pending_shared` DefsTeam[]
          - `pin_count` integer
          - `previous_names` DefsChannelName[]
          - `priority` number
          - `purpose` object, required
            - `creator` string, required
            - `last_set` integer, required
            - `value` string, required
          - `shared_team_ids` DefsTeam[]
          - `shares` object[]
            - `accepted_user` string
            - `is_active` boolean, required
            - `team` ObjsTeam, required
              - …
            - `user` string, required
          - `timezone_count` integer
          - `topic` object, required
            - `creator` string, required
            - `last_set` integer, required
            - `value` string, required
          - `unlinked` integer
          - `unread_count` integer
          - `unread_count_display` integer
          - `user` string
          - `version` integer
        - object
          - `created` integer, required
          - `has_pins` boolean
          - `id` string, required
          - `is_archived` boolean
          - `is_ext_shared` boolean
          - `is_frozen` boolean
          - `is_im` boolean, required
          - `is_open` boolean
          - `is_org_shared` boolean, required
          - `is_shared` boolean
          - `is_starred` boolean
          - `is_user_deleted` boolean
          - `last_read` string
          - `latest` union[]
            - union
              - …
          - `parent_conversation` union[]
            - union
              - …
          - `pin_count` integer
          - `priority` number, required
          - `shares` object[]
            - `date_create` integer, required
            - `id` string, required
            - `is_active` boolean, required
            - `name` string, required
            - `team` ObjsTeam, required
              - …
          - `unread_count` integer
          - `unread_count_display` integer
          - `user` string, required
          - `version` integer
  - `ok` true, required
  - `response_metadata` object
    - `next_cursor` string, 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/versions/7b951462b44f/schema)