---
title: "List team members (admin)"
method: GET
path: "/api/admin/teams/{teamId}/members"
tags: ["Admin", "Teams"]
---

# List team members (admin)

`GET /api/admin/teams/{teamId}/members`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/admin/teams/{teamId}/members`
- Auth: HTTP bearer

Gate: canAccessTeam. Owner, editor, viewer and legacy admin members of the team, plus platform admin/superadmin, get 200; outsiders 403; anonymous 401. Rows are ordered by role asc then createdAt asc, unpaged. Each row keeps the TeamAdmin scalars (id, teamId, userId, role, createdAt) and adds `user` { id, handle, name, profileUrl }. Email is not returned. Response is `Cache-Control: private, no-store`.

## Path parameters

- `teamId` string, required

## Response `200`

{ success, data: TeamMember[] }

- object
  - `success` boolean
  - `data` object[]
    - `id` string, required
    - `teamId` string, required
    - `userId` string, required
    - `role` 'owner' | 'editor' | 'viewer' | 'admin', required: Legacy `admin` rows may still exist; treat as editor.
    - `createdAt` string, date-time, required
    - `user` object, required: Display fields for the member (id, handle, name, profileUrl). Email is never returned.
      - `id` string, required
      - `handle` string, nullable, required
      - `name` string, nullable, required
      - `profileUrl` string, nullable, required

## Other responses

- `401`: { success: false, error, code: UNAUTHORIZED }
- `403`: { success: false, error, code: FORBIDDEN }
- `500`: { success: false, error, code: INTERNAL_ERROR }

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/admin/teams/:teamId/members/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
