---
title: "List channels"
method: GET
path: "/v1/providers/ms-teams/{channel_id}/channels"
tags: ["Providers", "Microsoft Teams"]
---

# List channels

`GET /v1/providers/ms-teams/{channel_id}/channels`

List the Microsoft Teams channels within a team. By default, archived and private channels are excluded from the results.

## Path parameters

- `channel_id` string, required

## Query parameters

- `ms_teams_tenant_object` string, required
- `team_id` string, required
- `query_options.$filter` string
- `query_options.$select` string

## Response `200`

OK

- ChannelsForMsTeamsProviderResponse — The response from a Microsoft Teams provider request, containing a list of channels.
  - `ms_teams_channels` object[], required — List of Microsoft Teams channels.
    - `createdDateTime` string — Microsoft Teams channel created date and time.
    - `description` string, nullable — Microsoft Teams channel description.
    - `displayName` string, required — Microsoft Teams channel name.
    - `id` string, required — Microsoft Teams channel ID.
    - `isArchived` boolean — Whether the Microsoft Teams channel is archived.
    - `membershipType` string — Microsoft Teams channel membership type.

---

[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)