---
title: "List Team V2"
method: GET
path: "/v2/team/list"
tags: ["team management"]
---

# List Team V2

`GET /v2/team/list`

Get a paginated list of teams with filtering and sorting options.

Parameters:
    user_id: Optional[str]
        Only return teams which this user belongs to
    organization_id: Optional[str]
        Only return teams which belong to this organization
    team_id: Optional[str]
        Filter teams by exact team_id match
    team_alias: Optional[str]
        Filter teams by partial team_alias match
    page: int
        The page number to return
    page_size: int
        The number of items per page
    sort_by: Optional[str]
        Column to sort by (e.g. 'team_id', 'team_alias', 'created_at')
    sort_order: str
        Sort order ('asc' or 'desc')
    status: Optional[str]
        Filter by status. Currently supports "deleted" to query deleted teams.

## Query parameters

- `user_id` string, nullable — Only return teams which this 'user_id' belongs to
- `organization_id` string, nullable — Only return teams which this 'organization_id' belongs to
- `team_id` string, nullable — Only return teams which this 'team_id' belongs to
- `team_alias` string, nullable — Only return teams which this 'team_alias' belongs to. Supports partial matching.
- `page` integer — Page number for pagination
- `page_size` integer — Number of teams per page
- `sort_by` string, nullable — Column to sort by (e.g. 'team_id', 'team_alias', 'created_at')
- `sort_order` string — Sort order ('asc' or 'desc')
- `status` string, nullable — Filter by status (e.g. 'deleted')

## Response `200`

Successful Response

- TeamListResponse — Response to get the list of teams
  - `teams` union[], required
    - union
      - LiteLLMTeamTableOutput
        - `team_alias` string, nullable
        - `team_id` string, required
        - `organization_id` string, nullable
        - `admins` unknown[]
          - unknown
        - `members` unknown[]
          - unknown
        - `members_with_roles` Member[]
          - `user_id` string, nullable — The unique ID of the user to add. Either user_id or user_email must be provided
          - `user_email` string, nullable — The email address of the user to add. Either user_id or user_email must be provided
          - `role` 'admin' | 'user', required — The role of the user within the team. 'admin' users can manage team settings and members, 'user' is a regular team member
        - `team_member_permissions` string[], nullable
        - `metadata` object, nullable
        - `tpm_limit` integer, nullable
        - `rpm_limit` integer, nullable
        - `max_budget` number, nullable
        - `soft_budget` number, nullable
        - `budget_duration` string, nullable
        - `models` unknown[]
          - unknown
        - `blocked` boolean
        - `router_settings` object, nullable
        - `access_group_ids` string[], nullable
        - `spend` number, nullable
        - `max_parallel_requests` integer, nullable
        - `budget_reset_at` string, date-time, nullable
        - `model_id` integer, nullable
        - `litellm_model_table` LiteLLMModelTableOutput
          - `id` integer, nullable
          - `model_aliases` union
            - object
            - string
          - `created_by` string, required
          - `updated_by` string, required
          - `team` LiteLLMTeamTableOutput — recursive
        - `object_permission` LiteLLMObjectPermissionTable — Represents a LiteLLM_ObjectPermissionTable record
          - `object_permission_id` string, required
          - `mcp_servers` string[], nullable
          - `mcp_access_groups` string[], nullable
          - `mcp_tool_permissions` object, nullable
          - `vector_stores` string[], nullable
          - `agents` string[], nullable
          - `agent_access_groups` string[], nullable
        - `updated_at` string, date-time, nullable
        - `created_at` string, date-time, nullable
        - `object_permission_id` string, nullable
      - LiteLLMDeletedTeamTableOutput — Recording of deleted teams for audit purposes. Mirrors LiteLLM_TeamTable plus metadata captured at deletion time.
        - `team_alias` string, nullable
        - `team_id` string, required
        - `organization_id` string, nullable
        - `admins` unknown[]
          - unknown
        - `members` unknown[]
          - unknown
        - `members_with_roles` Member[]
          - `user_id` string, nullable — The unique ID of the user to add. Either user_id or user_email must be provided
          - `user_email` string, nullable — The email address of the user to add. Either user_id or user_email must be provided
          - `role` 'admin' | 'user', required — The role of the user within the team. 'admin' users can manage team settings and members, 'user' is a regular team member
        - `team_member_permissions` string[], nullable
        - `metadata` object, nullable
        - `tpm_limit` integer, nullable
        - `rpm_limit` integer, nullable
        - `max_budget` number, nullable
        - `soft_budget` number, nullable
        - `budget_duration` string, nullable
        - `models` unknown[]
          - unknown
        - `blocked` boolean
        - `router_settings` object, nullable
        - `access_group_ids` string[], nullable
        - `spend` number, nullable
        - `max_parallel_requests` integer, nullable
        - `budget_reset_at` string, date-time, nullable
        - `model_id` integer, nullable
        - `litellm_model_table` LiteLLMModelTableOutput
          - `id` integer, nullable
          - `model_aliases` union
            - object
            - string
          - `created_by` string, required
          - `updated_by` string, required
          - `team` LiteLLMTeamTableOutput
            - `team_alias` string, nullable
            - `team_id` string, required
            - `organization_id` string, nullable
            - `admins` unknown[]
              - …
            - `members` unknown[]
              - …
            - `members_with_roles` Member[]
              - …
            - `team_member_permissions` string[], nullable
            - `metadata` object, nullable
            - `tpm_limit` integer, nullable
            - `rpm_limit` integer, nullable
            - `max_budget` number, nullable
            - `soft_budget` number, nullable
            - `budget_duration` string, nullable
            - `models` unknown[]
              - …
            - `blocked` boolean
            - `router_settings` object, nullable
            - `access_group_ids` string[], nullable
            - `spend` number, nullable
            - `max_parallel_requests` integer, nullable
            - `budget_reset_at` string, date-time, nullable
            - `model_id` integer, nullable
            - `litellm_model_table` LiteLLMModelTableOutput — recursive
            - `object_permission` LiteLLMObjectPermissionTable — Represents a LiteLLM_ObjectPermissionTable record
              - …
            - `updated_at` string, date-time, nullable
            - `created_at` string, date-time, nullable
            - `object_permission_id` string, nullable
        - `object_permission` LiteLLMObjectPermissionTable — Represents a LiteLLM_ObjectPermissionTable record
          - `object_permission_id` string, required
          - `mcp_servers` string[], nullable
          - `mcp_access_groups` string[], nullable
          - `mcp_tool_permissions` object, nullable
          - `vector_stores` string[], nullable
          - `agents` string[], nullable
          - `agent_access_groups` string[], nullable
        - `updated_at` string, date-time, nullable
        - `created_at` string, date-time, nullable
        - `object_permission_id` string, nullable
        - `id` string, nullable
        - `deleted_at` string, date-time, nullable
        - `deleted_by` string, nullable
        - `deleted_by_api_key` string, nullable
        - `litellm_changed_by` string, nullable
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/79928a3d37d3/schema)