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

# List teams

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

Get a list of teams belonging to the Microsoft Entra tenant. 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
- `query_options.$filter` string
- `query_options.$select` string
- `query_options.$top` integer
- `query_options.$skiptoken` string

## Response `200`

OK

- TeamsForMsTeamsProviderResponse — The response from a Microsoft Teams provider request, containing a list of teams.
  - `ms_teams_teams` object[], required — List of Microsoft Teams teams.
    - `description` string, nullable — Microsoft Teams team description.
    - `displayName` string, required — Microsoft Teams team display name.
    - `id` string, required — Microsoft Teams team ID.
  - `skip_token` string, nullable, required — [OData param](https://learn.microsoft.com/en-us/graph/query-parameters) passed to the Microsoft Graph API to retrieve the next page of results.

---

[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/versions/4b8499dddbc5/schema)