Get Tournament Bracket

Returns the complete bracket structure for a tournament.

This endpoint provides the full tournament bracket including:

  • Tournament Metadata: Name, type, status, dates, league
  • Groups: Group stage divisions with standings (for group_knockout tournaments)
  • Rounds: Bracket rounds with matchups, scores, and advancement status
  • Events: Related event entities (optional, when include_events=true)

Bracket Data Sources

The bracket can be built from two sources:

  1. Tournament Entity: Uses tournament.rounds field if populated with complete data
  2. Events: Reconstructs bracket from events with tournament_id and tournament_round

The endpoint automatically uses whichever source provides the most complete bracket structure.

Bracket Types

Single Elimination (March Madness, CFP)

  • Rounds progress: First Round → Second Round → Sweet 16 → Elite 8 → Final Four → Championship
  • Each matchup is a single game
  • Winner advances, loser eliminated

Best-of-Series (NBA, NHL, MLB, NFL Playoffs)

  • Rounds represent playoff series (First Round, Conference Semifinals, etc.)
  • Each matchup is a best-of-N series (best of 7, best of 5)
  • Series score tracked in series_score field
  • Individual games tracked as separate events

Group + Knockout (World Cup, UEFA Champions League)

  • Groups: Round-robin play with standings
  • Rounds: Knockout stage after group play (Round of 16, Quarterfinals, etc.)
  • Top teams from groups advance to knockout rounds

Matchup Information

Each matchup includes:

  • Team information (name, abbreviation, seed)
  • Scores (home_score, away_score for games, series_score for series)
  • Winner designation (home/away)
  • Status (scheduled, in_progress, completed, pending)
  • Event linking (event_id when game events are created)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Tournament ID (common_model_id UUID)

Query Params
boolean

Include related event entities in response. Events provide detailed game information including participants, statistics, and live scoreboard data.

Responses

Callback
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json