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

# Get Team

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

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/workspaces/{workspaceId}/teams/{teamId}`
- 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/:teamId/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch details of a specific team

## Path parameters

- `workspaceId` string, required
- `teamId` string, required

## Response `200`

Team details

- TeamDetailV3: Detailed team information for v3 API
  - `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` TeamMemberV3Response[], required: Team members
    - `user_email` string, email, required: User email address
    - `user_id` string, required: User ID
    - `team_role` 'member' | 'owner', required: Team role
  - `inherited_members` InheritedTeamMemberV3[]: Members inherited from ancestor teams
    - `user_email` string, required: Member email address
    - `user_id` string, required: Member user ID
    - `team_role` 'owner' | 'member', required: Member role in the ancestor team
    - `inherited_from_team_id` string, required: ID of the ancestor team this member is inherited from
    - `inherited_from_team_title` string, required: Title of the ancestor team this member is inherited from

## 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.
- `422`: The request was well formed but could not be acted on — most commonly a referenced base, table, field, view, script, dashboard, widget or workflow does not exist.

## Changes

- **2026-10-13** `2ba4267a99d7`: 1 warning, 4 info
  - deleted the `query` request parameter `include_workspace`
  - api operation id `teams-get-v3` removed and replaced with `teams-read`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - …1 more

[Operation history](https://skmtc.dev/nocodb/apis/nocodb-v3/changes/api/v3/meta/workspaces/:workspaceId/teams/:teamId/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)