---
title: "List teams"
method: GET
path: "/v2/teams"
tags: ["Teams"]
---

# List teams

`GET /v2/teams`

## Request

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

**Attention**: This endpoint will return only paginated responses starting June 2, 2026. To start returning paginated responses before that date, include the query parameter `limit` in your request.

  List all teams in Sigma.

## Query parameters

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

## Response `200`

The response body.

- union
  - V2TeamsGetResponsesContentApplicationJsonSchemaOneOf0Items[]: One page of results
    - `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
  - TeamsListTeamsResponse2001: Multiple pages of results
    - `entries` V2TeamsGetResponsesContentApplicationJsonSchemaOneOf1EntriesItems[], required
      - `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

---

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