---
title: "List Teams"
method: GET
path: "/api/v3/meta/workspaces/{workspaceId}/teams"
tags: ["Teams"]
---

# List Teams

`GET /api/v3/meta/workspaces/{workspaceId}/teams`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/workspaces/{workspaceId}/teams`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/workspaces/:workspaceId/teams/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of teams in a workspace.

**Note**: Team Management is a plan feature. A workspace whose plan does not include it is rejected with `403` on every team operation.

## Path parameters

- `workspaceId` string, required

## Response `200`

List of teams

- object
  - `list` TeamV3[], required
    - `id` string, required: Unique team identifier
    - `title` string, required: Team name
    - `icon` string, nullable: Team icon (emoji or icon identifier)
    - `icon_type` 'EMOJI' | 'ICON', nullable: Team icon type
    - `badge_color` string: Team badge color (hex code)
    - `members_count` integer, required: Number of team members
    - `managers_count` integer: Number of team managers
    - `fk_org_id` string: Organization ID (for Cloud Enterprise)
    - `fk_workspace_id` string: Workspace ID (for other plans)
    - `created_at` string, date-time: Team creation timestamp
    - `updated_at` string, date-time: Team last update timestamp
    - `fk_parent_team_id` string, nullable: Parent team ID. Null = root team.
    - `depth` integer: Depth in the team tree. Root teams have depth 0.
    - `path` string: Materialized path for efficient ancestor/descendant queries.
    - `is_member` boolean: Whether the requesting user is a member of this team.
    - `scim_managed` boolean: Whether the team is provisioned by SCIM from an identity provider.
    - `managers` string[]: List of user IDs who are owners/managers of this team.

## Other responses

- `401`: No credential was supplied, it was not valid, or this operation does not accept the kind of credential that was sent.
- `403`: Authenticated, but not allowed: the role is too low, the token scope does not cover the operation, or the plan does not include the feature or allows no more of this resource.

## Changes

- **2026-10-13** `2ba4267a99d7`: 4 info
  - api operation id `teams-list-v3` removed and replaced with `teams-list`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the optional property `list/items/scim_managed` to the response with the `200` status

[Operation history](https://skmtc.dev/nocodb/apis/nocodb-v3/changes/api/v3/meta/workspaces/:workspaceId/teams/get.md)

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)