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

# List tournament participants

`GET /tournaments/{identifier}/participants`

## Request

- Base URL: `https://teambattles.gg/api/v1`
- URL: `https://teambattles.gg/api/v1/tournaments/{identifier}/participants`
- Auth: HTTP bearer

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.

## Changes

- **2026-07-23** `33b122ff59d0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/teambattles/apis/teambattles-api/changes/tournaments/:identifier/participants/get.md)

---

[API](https://skmtc.dev/teambattles/apis/teambattles-api.md) - [All operations](https://skmtc.dev/teambattles/apis/teambattles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/teambattles/apis/teambattles-api/revisions/75b07daef7dc?raw)