Skip to main content
GET
Get tournament

Authorizations

Authorization
string
header
required

Bearer token issued by Softmax

Path Parameters

tournament_id
string
required

Tournament to return.

Pattern: ^tour_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Response

Successful Response

Tournament definition, bracket state, entrants, and lifecycle status.

tournament_id
string
required

Tournament ID.

league_id
string
required

League that owns the tournament.

name
string
required

Tournament display name.

status
enum<string>
required

Current tournament lifecycle state.

Available options:
draft,
locked,
running,
completed,
cancelled,
failed
definition
TournamentDefinition · object
required

Tournament configuration frozen for this record.

frozen_entrants
FrozenEntrant · object[] | null
required

Entrants resolved at lock time, or null while the tournament is a draft.

visualization
DoubleEliminationView · object | null
required

Client-renderable bracket state after the tournament locks.

placements
Placement · object[] | null
required

Final placements after completion.

locked_at
string<date-time> | null
required

Time the definition and entrants were locked.

locked_by
string | null
required

User that locked the tournament.

started_at
string<date-time> | null
required

Time tournament execution started.

completed_at
string<date-time> | null
required

Time the tournament reached a terminal state.

error
string | null
required

Terminal failure reason, when the tournament failed.

created_at
string<date-time>
required

Time the tournament draft was created.

idempotency_key
string | null
required

Caller-supplied key used to deduplicate tournament creation.

requester_user_id
string
required

User that created the tournament.

host_division_id
string | null
required

Division used to execute tournament rounds.

wave_experience_request_ids
Wave Experience Request Ids · object
required

Experience request IDs keyed by tournament wave.