---
title: "List tournament participants"
method: GET
path: "/tournaments/{identifier}/participants"
tags: ["Tournament Discovery"]
---

# List tournament participants

`GET /tournaments/{identifier}/participants`

Returns every participating team with its tournament roster, resolved by slug. Includes pending, approved, withdrawn, and disqualified entries - filter on `status` for the active field. A tournament you may not view answers 404. Requires tournaments.tournament_public:read.

## Path parameters

- `identifier` string, required — Tournament slug.

## Response `200`

The tournament participants.

- TournamentParticipantsResponse — Tournament participants.
  - `participants` TournamentParticipant[], required — Every participant row for the tournament, in creation order.
    - `id` string, required — Participant ID.
    - `teamId` string, required — Team ID.
    - `teamName` string, required — Team display name.
    - `teamAvatarUrl` string, nullable — Team avatar URL.
    - `status` string, required — PENDING, APPROVED, DENIED, WITHDRAWN, or DISQUALIFIED.
    - `seed` integer — Assigned seed, if seeding has run.
    - `checkedInAt` number — Check-in timestamp (epoch milliseconds).
    - `finalPlacement` integer — Placement persisted at finalization. Present only once the tournament ends.
    - `roster` TournamentRosterMember[], required — Tournament roster.
      - `id` string, required — User ID.
      - `username` string — Username.
      - `name` string — Display name.
      - `source` string, required — How the member joined the tournament roster.
      - `avatarUrl` string, nullable — Avatar image URL.
  - `count` integer, required — Number of participants returned.
  - `timestamp` string, required — Response generation time (ISO 8601).

## Other responses

- `401` — Missing or invalid API key.
- `403` — API key lacks the required permission.
- `404` — Resource not found.
- `429` — Rate limited.
- `500` — Internal server error.

---

[API](https://skmtc.net/teambattles/apis/teambattles-api.md) · [All operations](https://skmtc.net/teambattles/apis/teambattles-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/teambattles/teambattles-api/revisions/2ffe8fb53b7d/schema)