---
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`

## Request

- Base URL: `https://api.knock.app`
- URL: `https://api.knock.app/v1/providers/ms-teams/{channel_id}/teams`
- Auth: HTTP bearer

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.dev/knocklabs/apis/knock-api.md) · [All operations](https://skmtc.dev/knocklabs/apis/knock-api/llms.txt) · [OpenAPI document](https://skmtc.dev/knocklabs/apis/knock-api/revisions/dd3b76c7036d?raw)