---
title: "List Team Users"
method: GET
path: "/v2/teams/{team_id}/users"
tags: ["Team User API"]
---

# List Team Users

`GET /v2/teams/{team_id}/users`

List team users. Filter by team_id and/or user_id.

## Path parameters

- `team_id` string, required — Filter by team ID. Required when using /v2/teams/{team_id}/users path.

## Query parameters

- `userId` string — Filter by user ID. If not provided, returns all users in the team.
- `pageSize` integer — Maximum number of results to return. Default is 10000, maximum is 10000.
- `pageToken` string — Token for pagination. Leave empty for the first request.

## Response `200`

Success

- SvauthPublicListTeamUsersResponse
  - `data` SvauthPublicTeamUser[] — The list of team users.
    - `teamId` string
    - `userId` string
    - `role` 'TEAM_USER_ROLE_UNSPECIFIED' | 'TEAM_USER_ROLE_AGENT' | 'TEAM_USER_ROLE_MANAGER' | 'TEAM_USER_ROLE_BUILDER' | 'TEAM_USER_ROLE_VIEWER' | 'TEAM_USER_ROLE_CONTRIBUTOR' | 'TEAM_USER_ROLE_DRAFTER' | 'TEAM_USER_ROLE_READONLY_AGENT' | 'TEAM_USER_ROLE_APP_BUILDER'
    - `createdAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `id` string — Composite identifier in the format {team_id}:{user_id}.
  - `nextPageToken` string, nullable — Token for retrieving the next page of results. Empty if no more results.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/versions/0549515e9384/schema)