---
title: "GET /api/teams/workspace/{workspace_id}/"
method: GET
path: "/api/teams/workspace/{workspace_id}/"
tags: ["Teams"]
---

# GET /api/teams/workspace/{workspace_id}/

`GET /api/teams/workspace/{workspace_id}/`

Lists all teams in a given workspace.

## Path parameters

- `workspace_id` integer, required

## Query parameters

- `search` string
- `sorts` string

## Response `200`

- TeamResponse[]
  - `id` integer, required
  - `name` string, required — A human friendly name for this team.
  - `workspace` integer, required — The workspace that this team belongs to.
  - `created_on` string, date-time, required
  - `updated_on` string, date-time, required
  - `default_role` string — The uid of the role this team has in its workspace.
  - `subject_count` integer, required — The amount of subjects (e.g. users) that are currently assigned to this team.
  - `subject_sample` TeamSampleSubject[] — A sample, by default 10, of the most recent subjects to join this team.
    - `subject_id` integer, required — The subject's unique identifier.
    - `subject_type` 'auth.User', required — * `auth.User` - auth.User
    - `subject_label` string, required — The subject's label. Defaults to a user's first name.
    - `team_subject_id` integer, required — The team subject unique identifier.

## Other responses

- `404`

---

[API](https://skmtc.net/baserow/apis/baserow-api-spec.md) · [All operations](https://skmtc.net/baserow/apis/baserow-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baserow/baserow-api-spec/versions/0c490e5b0c7f/schema)
