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

# Batch Get Teams

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

## Request

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

Returns the requested set of Teams by name, in the order requested. All names must belong to the organization specified by parent. A maximum of 100 teams can be retrieved per request. The request fails if any team does not exist or the caller cannot view it.

## Path parameters

- `organization` string, required

## Query parameters

- `names` string[], required

## Response `200`

A successful response.

- BatchGetTeamsResponse: Response message for [ClientService.BatchGetTeams](#/operations/ClientService_BatchGetTeams).
  - `teams` Team[]: The requested teams, in the order of the request's `names`.
    - `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.

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