get
https://api.sportsstack.io/api/v1/tournaments//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:
- Tournament Entity: Uses
tournament.roundsfield if populated with complete data - Events: Reconstructs bracket from events with
tournament_idandtournament_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_scorefield - 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
