Overview Returns detailed tournament bracket information showing a team’s journey through knockout competitions. This includes all stages (rounds), matchups, game results, and progression paths through tournaments like cup competitions and playoffs.
Query Parameters The unique identifier of the team/competitor to retrieve brackets for. Example: 110 for Manchester City
Comma-separated list of competition IDs to filter brackets. Example: 9,572 for EFL Cup and UEFA Champions League
When true, returns only brackets with currently live games.
The bookmaker ID to use for betting odds display.
Application type identifier. Automatically determined by the API.
Language identifier for localized content. Automatically determined.
Timezone for date/time values (auto-resolved, or specify e.g., America/New_York). All startTime fields use ISO 8601 format with a dynamic timezone offset.
Country identifier for regional content. Automatically determined.
Response Internal versioning ID for caching and incremental updates.
The update ID that was requested. -1 indicates latest data was requested.
Cache time-to-live in seconds (typically 300 seconds / 5 minutes).
Array of tournament brackets the team participates in. Show Bracket Object Properties
Season number identifier.
Season name (e.g., “2025/2026”).
Whether to display the season name.
Full bracket title (e.g., “EFL Cup 2025/2026 Bracket”).
The competition this bracket belongs to.
Whether the competition has league standings.
Whether the competition has knockout brackets.
Display title for knockout rounds (e.g., “Knockout”).
Whether this is the current active season.
Array of tournament stages/rounds. Show Stage Object Properties
Stage number (sequential order).
Stage name (e.g., “Quarter Finals”, “Semi Finals”, “Final”).
Whether to display the stage name.
Whether this stage has group standings.
Whether this is the final stage.
Type of stage (3 = knockout).
Whether winners progress to the next stage.
Whether this is the current active stage.
Array of matchups/groups within this stage. Show Group Object Properties
Group name (e.g., “Group 1”, “Final”).
Whether to display the group name.
Whether this group has standings.
Array of teams in this matchup. Show Participant Properties
Participant position (1 = home, 2 = away).
Whether to use this name for display.
Team abbreviation (e.g., “MCI”, “CHE”).
Whether this team has qualified/advanced.
Stage number the team advanced from.
Group number the team advanced from.
Position in origin group (1 = winner).
Array of games in this matchup. Show Bracket Game Properties
Game number in the matchup (for two-leg ties).
ISO 8601 formatted game start time.
Stadium/venue information. Full game details including competitors and scores.
Aggregate score as [home, away] array.
Participant number that qualifies (1 or 2).
Destination stage for the winner.
Destination group for the winner.
Description of the win (for finals, e.g., “Chelsea won the Club World Cup”).
Number of games in this matchup.
Number of currently live games.
Whether to group display elements.
Array of sports referenced in the response.
Array of countries referenced in the response.
Array of competitions referenced in the response.
Array of teams/competitors referenced in the response.
Array of games referenced in the response.
Array of bookmakers for odds display.
Stage Types Value Description 1 League/Group Stage 3 Knockout/Elimination
Example Request curl -X GET "https://v1.football.sportsapipro.com/brackets?competitor=110&live=false" \ -H "x-api-key: YOUR_API_KEY"
Example Response { "lastUpdateId" : 5495179323 , "requestedUpdateId" : -1 , "ttl" : 300 , "brackets" : [ { "num" : 66 , "name" : "2025/2026" , "useName" : false , "title" : "EFL Cup 2025/2026 Bracket" , "competitionId" : 9 , "hasStandings" : false , "hasBrackets" : true , "stages" : [ { "num" : 6 , "name" : "Quarter Finals" , "useName" : true , "hasStandings" : false , "isFinal" : false , "stageType" : 3 , "groups" : [ { "num" : 3 , "name" : "Group 3" , "useName" : false , "hasStandings" : false , "participants" : [ { "num" : 1 , "name" : "Manchester City" , "useName" : true , "competitorId" : 110 , "symbolicName" : "MCI" , "isQualified" : true }, { "num" : 2 , "name" : "Brentford" , "useName" : true , "competitorId" : 63 , "symbolicName" : "BRE" , "isQualified" : false } ], "games" : [ { "num" : 1 , "startTime" : "2025-12-17T19:30:00+00:00" , "gameId" : 4609055 , "venue" : { "id" : 3911 , "name" : "Etihad Stadium" , "shortName" : "etihad-stadium" }, "game" : { "id" : 4609055 , "statusText" : "Ended" , "homeCompetitor" : { "id" : 110 , "name" : "Manchester City" , "score" : 2.0 , "isWinner" : true }, "awayCompetitor" : { "id" : 63 , "name" : "Brentford" , "score" : 0.0 , "isWinner" : false } } } ], "score" : [ 2.0 , 0.0 ], "toQualify" : 1 , "destStageNum" : 7 , "destGroupNum" : 2 } ] } ], "knockoutTitle" : "Knockout" , "isCurrentSeason" : true } ], "sports" : [ ... ], "countries" : [ ... ], "competitions" : [ ... ], "competitors" : [ ... ], "games" : [ ... ], "bookmakers" : [ ... ] }
Use Cases
Tournament Tracker : Display a team’s complete tournament journey with all knockout roundsBracket Visualization : Build interactive bracket displays showing progression pathsCup Competition History : Show historical tournament runs across multiple seasonsLive Tournament Updates : Track ongoing knockout matches with live=trueMulti-Competition View : Display brackets from multiple tournaments simultaneously
Notes
Brackets are hierarchical: Season → Stages → Groups → Games
Each stage can contain multiple groups (matchups)
Two-leg ties will have multiple games per group
The originStageNum and originGroupNum fields trace the bracket path
Finals include a winDescription field with the championship result
