Team Brackets

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

integer

required

The unique identifier of the team/competitor to retrieve brackets for.Example: 110 for Manchester City

string

Comma-separated list of competition IDs to filter brackets.Example: 9,572 for EFL Cup and UEFA Champions League

boolean

default:"false"

When true, returns only brackets with currently live games.

integer

default:"14"

The bookmaker ID to use for betting odds display.

integer

Application type identifier. Automatically determined by the API.

integer

Language identifier for localized content. Automatically determined.

string

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.

integer

Country identifier for regional content. Automatically determined.

Response

integer

Internal versioning ID for caching and incremental updates.

integer

The update ID that was requested. -1 indicates latest data was requested.

integer

Cache time-to-live in seconds (typically 300 seconds / 5 minutes).

array

Array of tournament brackets the team participates in.

Show Bracket Object Properties

integer

Season number identifier.

string

Season name (e.g., “2025/2026”).

boolean

Whether to display the season name.

string

Full bracket title (e.g., “EFL Cup 2025/2026 Bracket”).

integer

The competition this bracket belongs to.

boolean

Whether the competition has league standings.

boolean

Whether the competition has knockout brackets.

string

Display title for knockout rounds (e.g., “Knockout”).

boolean

Whether this is the current active season.

array

Array of tournament stages/rounds.

Show Stage Object Properties

integer

Stage number (sequential order).

string

Stage name (e.g., “Quarter Finals”, “Semi Finals”, “Final”).

boolean

Whether to display the stage name.

boolean

Whether this stage has group standings.

boolean

Whether this is the final stage.

integer

Type of stage (3 = knockout).

boolean

Whether winners progress to the next stage.

boolean

Whether this is the current active stage.

array

Array of matchups/groups within this stage.

Show Group Object Properties

integer

Group/matchup number.

string

Group name (e.g., “Group 1”, “Final”).

boolean

Whether to display the group name.

boolean

Whether this group has standings.

array

Array of teams in this matchup.

Show Participant Properties

integer

Participant position (1 = home, 2 = away).

string

Team display name.

boolean

Whether to use this name for display.

integer

Unique team identifier.

string

Team abbreviation (e.g., “MCI”, “CHE”).

boolean

Whether this team has qualified/advanced.

integer

Stage number the team advanced from.

integer

Group number the team advanced from.

integer

Position in origin group (1 = winner).

array

Array of games in this matchup.

Show Bracket Game Properties

integer

Game number in the matchup (for two-leg ties).

string

ISO 8601 formatted game start time.

integer

Unique game identifier.

object

Stadium/venue information.

Show Venue Properties

integer

Unique venue identifier.

string

Venue name.

string

URL-friendly venue name.

object

Full game details including competitors and scores.

integer

Sport type identifier.

integer

Season number.

integer

Stage number.

integer

Group number.

array

Aggregate score as [home, away] array.

integer

Participant number that qualifies (1 or 2).

integer

Destination stage for the winner.

integer

Destination group for the winner.

string

Description of the win (for finals, e.g., “Chelsea won the Club World Cup”).

integer

Number of games in this matchup.

integer

Number of currently live games.

boolean

Whether to group display elements.

array

Array of sports referenced in the response.

array

Array of countries referenced in the response.

array

Array of competitions referenced in the response.

array

Array of teams/competitors referenced in the response.

array

Array of games referenced in the response.

array

Array of bookmakers for odds display.

Stage Types

Value	Description
1	League/Group Stage
3	Knockout/Elimination

Example Request

curl -X GET "https://api.sportsapipro.com/v1/football/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 rounds
Bracket Visualization: Build interactive bracket displays showing progression paths
Cup Competition History: Show historical tournament runs across multiple seasons
Live Tournament Updates: Track ongoing knockout matches with live=true
Multi-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

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Overview

Query Parameters

Response

Stage Types

Example Request

Example Response

Use Cases

Notes

​Overview

​Query Parameters

​Response

​Stage Types

​Example Request

​Example Response

​Use Cases

​Notes

Overview

Query Parameters

Response

Stage Types

Example Request

Example Response

Use Cases

Notes