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)
Callback
Language
Credentials
Bearer
Response
Click Try It! to start a request and see the response here!