---
title: "List Teams"
method: GET
path: "/v1/organizations/{organization}/teams"
tags: ["ClientService"]
---

# List Teams

`GET /v1/organizations/{organization}/teams`

## Request

- Base URL: `https://api.thirdfort.dev/client/api`
- URL: `https://api.thirdfort.dev/client/api/v1/organizations/{organization}/teams`
- Auth: HTTP bearer

Lists Teams within the specified organization. Results are paginated and can be filtered. Deleted teams are not returned.

## Path parameters

- `organization` string, required

## Query parameters

- `pageSize` integer
- `pageToken` string
- `filter` string

## Response `200`

A successful response.

- ListTeamsResponse: Response message for [ClientService.ListTeams](#/operations/ClientService_ListTeams).
  - `teams` Team[]: The teams matching the request.
    - `name` string: The unique resource name of the team. Format: `organizations/{organization}/teams/{team}`. This field is system-generated and immutable.
    - `displayName` string, required: Required. The human readable name of the team.
    - `brand` string, required: Required. The resource name of the [Brand](#/schemas/Brand) this team uses. The brand must belong to the same organization as the team. Format: `organizations/{organization}/brands/{brand}`.
    - `description` string: Optional. A human readable description of the team.
    - `deleteTime` string, date-time: The time at which the team was deleted. Unset for a live team. A deleted team is still returned by [GetTeam](#/operations/ClientService_GetTeam) and [BatchGetTeams](#/operations/ClientService_BatchGetTeams), but is excluded from [ListTeams](#/operations/ClientService_ListTeams). A deleted team cannot be restored.
  - `nextPageToken` string: A token to retrieve the next page of results. Pass this value in the `page_token` field in the subsequent request to retrieve the next page. This field will be empty if there are no more results to retrieve.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/thirdfort/apis/thirdfort-client-api.md) - [All operations](https://skmtc.dev/thirdfort/apis/thirdfort-client-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thirdfort/apis/thirdfort-client-api/revisions/26eb85e05917?raw)