---
title: "List channels"
method: GET
path: "/v1/providers/slack/{channel_id}/channels"
tags: ["Providers", "Slack"]
---

# List channels

`GET /v1/providers/slack/{channel_id}/channels`

List Slack channels for a Slack workspace.

## Path parameters

- `channel_id` string, required

## Query parameters

- `access_token_object` string, required
- `query_options.cursor` string
- `query_options.limit` integer
- `query_options.exclude_archived` boolean
- `query_options.types` string
- `query_options.team_id` string

## Response `200`

OK

- ChannelsForSlackProviderResponse — The response from a Slack provider request, containing a list of channels.
  - `next_cursor` string, nullable, required — Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first "page" of the collection.
  - `slack_channels` object[], required — List of Slack channels.
    - `context_team_id` string, required — The team ID that the Slack channel belongs to.
    - `id` string, required — A Slack channel ID from the Slack provider.
    - `is_im` boolean, required — Whether the Slack channel is an IM channel.
    - `is_private` boolean, required — Whether the Slack channel is private.
    - `name` string, required — Slack channel name.

## Other responses

- `403` — Forbidden

---

[API](https://skmtc.net/knocklabs/apis/knock-api.md) · [All operations](https://skmtc.net/knocklabs/apis/knock-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/knocklabs/knock-api/revisions/4b8499dddbc5/schema)