Participants

Participants are the players or teams registered in a tournament. TournamentSuite supports both solo participants (individual players) and team participants depending on the tournament's teamSize configuration.

Participant types

For team tournaments, one player acts as the team captain and registers on behalf of the team. Other members can be added to the roster before check-in closes.

Registration flow

Register → (optional) Fill required fields → Check in → Seed into bracket

Register for a tournament

POST /api/v1/tournaments/:id/participate
Authorization: Bearer USER_ACCESS_TOKEN
Content-Type: application/json

{
  "teamName": "Alpha Squad",
  "players": ["user-id-1", "user-id-2", "user-id-3", "user-id-4", "user-id-5"]
}

For solo tournaments, no body is required — the authenticated user is registered directly.

List participants

GET /api/v1/tournaments/:id/participants
X-API-Key: YOUR_API_KEY

Check in

Check-in confirms a participant's attendance before the tournament starts. The check-in window opens and closes according to the tournament's schedule.

POST /api/v1/tournaments/:id/checkin
Authorization: Bearer USER_ACCESS_TOKEN

Participants who do not check in before the deadline may be removed from the bracket at the organizer's discretion.

Custom registration fields

Tournaments can require additional information at registration — for example, a game-specific ID like a Riot account name. These custom fields are defined by the organizer when setting up the tournament.

To discover what fields a tournament requires before attempting registration:

GET /api/v1/tournaments/:id

Check the registrationFields array in the response. Submit the required values in the registration request body under the customFields key.

Participant statuses

Managing participants (organizer)

Organizers can remove or disqualify participants before or during a tournament:

DELETE /api/v1/tournaments/:id/participants/:participantId
X-API-Key: YOUR_API_KEY

Removing a participant after the bracket is generated will trigger automatic advancement for their scheduled opponents.