---
title: "List teams (Paginated)"
method: GET
path: "/v2.1/teams"
tags: ["Teams"]
---

# List teams (Paginated)

`GET /v2.1/teams`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2.1/teams`
- Auth: HTTP bearer

**Attention:** This API endpoint uses pagination by default.

  List all teams in Sigma.

## Query parameters

- `page` string
- `limit` number, double
- `name` string
- `description` string
- `visibility` 'public' | 'private'

## Response `200`

The response body.

- TeamsV21ListTeamsResponse200
  - `entries` V21TeamsGetResponsesContentApplicationJsonSchemaEntriesItems[], required: Array of results returned by the endpoint
    - `teamId` string, required
    - `createdBy` string, required
    - `updatedBy` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `name` string, required
    - `description` string, nullable, required
    - `visibility` 'public' | 'private', required
    - `isArchived` boolean
  - `nextPage` string, nullable, required: Returns a string that can be used as the `page` parameter in the next request to fetch the next page of results. The last page of results returns `null`.
  - `total` number, double: Total number of results. Useful to determine if there is a need to paginate.
  - `hasMore` boolean: **[Deprecated]** Indicates whether more results are available.

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)