---
title: "List the tournament roster"
method: GET
path: "/v1/tournaments/{tournament_id}/participants"
tags: ["Tournament Participants"]
---

# List the tournament roster

`GET /v1/tournaments/{tournament_id}/participants`

## Request

- Base URL: `https://api.hify.club`
- URL: `https://api.hify.club/v1/tournaments/{tournament_id}/participants`
- Auth: API key in header `X-User-Token`

Admin only. Every participant — users and the anonymous participants a partner feed created — with the name each renders under, ordered by id and paged (X-Total-Count / X-Total-Pages).

## Query parameters

- `participant_type` 'User' | 'AnonymousTournamentParticipant'
- `page` integer
- `per_page` integer

## Response `200`

Participants

- TournamentParticipant[]
  - `id` integer
  - `tournament_id` string, uuid
  - `participant_type` 'User' | 'AnonymousTournamentParticipant'
  - `participant_id` string, uuid
  - `seed` integer, nullable
  - `name` string, nullable: The name the participant renders under.
  - `external_id` string, nullable: The partner's own player id, for an AnonymousTournamentParticipant a feed created. Null for a User.
  - `linked_user_id` string, uuid, nullable: The account an anonymous participant was linked to when the feed's phone number found one. Null for a User.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden — admin access required
- `404`: Tournament not found
- `422`: Unknown participant_type

---

[API](https://skmtc.dev/hify/apis/hify-apis.md) - [All operations](https://skmtc.dev/hify/apis/hify-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/hify/apis/hify-apis/revisions/b5920403538d?raw)