---
title: "List Teams"
method: GET
path: "/api/v1/auth/teams/"
tags: ["Teams"]
---

# List Teams

`GET /api/v1/auth/teams/`

Get a paginated list of teams in the workspace.

## Query parameters

- `include_archived` boolean
- `only_joined` boolean
- `only_write` boolean
- `page` integer

## Response `200`

OK

- V1PagedTeamOut
  - `results` V1TeamOut[], required
    - `sidebar_settings` object, required
    - `workspace_id` string, uuid, required
    - `empty_state` V1ExistDict
      - `catalog` V1ExistValue, required
        - `is_empty` boolean, required
      - `collection` V1ExistValue, required
        - `is_empty` boolean, required
      - `glossary` V1ExistValue, required
        - `is_empty` boolean, required
      - `document` V1ExistValue, required
        - `is_empty` boolean, required
      - `question` V1ExistValue, required
        - `is_empty` boolean, required
      - `bi_dashboard` V1ExistValue, required
        - `is_empty` boolean, required
    - `id` string, uuid
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `name` string, required
    - `icon` string
    - `type` string, required
    - `description` string
    - `archived` boolean
    - `is_default_team` boolean
    - `onboarding_completed` boolean
  - `count` integer, required
  - `total_pages` integer, required
  - `meta` V1OutputMeta, required
    - `page` integer, required
    - `previous_page` integer
    - `next_page` integer
  - `links` V1OutputLinks, required
    - `previous` string
    - `next` string

---

[API](https://skmtc.dev/secoda/apis/secoda-api.md) · [All operations](https://skmtc.dev/secoda/apis/secoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/secoda/secoda-api/revisions/e6d760bd7a94/schema)