---
title: "Get team roster"
method: GET
path: "/api/teams/{id}/roster"
tags: ["Teams"]
---

# Get team roster

`GET /api/teams/{id}/roster`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/teams/{id}/roster`
- Auth: none required

Public real-player roster for the lineup builder. { rosterVerifiedByClubAt: ISO-8601 | null, players: [{ id, name, jersey, position, role, duty, photo? }] }. rosterVerifiedByClubAt is null until a club admin confirms the roster. `photo` is omitted when the player has no art. `availability?` ({ status: out|day-to-day|injured-reserve|suspended|questionable, detail?, expectedReturn?, updatedAt? }) is a player-level field, omitted entirely when the player is available. ?season= is accepted and echoed; the roster is a DB snapshot with no season axis, so every season reads the same list. 404 if team is missing.

## Path parameters

- `id` string, required

## Query parameters

- `season` integer

## Response `200`

{ success, data: { rosterVerifiedByClubAt, players, season? } }

## Other responses

- `400`: Invalid season
- `404`: Team not found

## Changes

- **2026-11-18** `6de639c52609`: 2 info
  - added the new optional `query` request parameter `season`
  - added the non-success response with the status `400`
- **2026-08-17** `6a5e2c1b8022`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/teams/:id/roster/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)
