Skip to main content

Cup Bracket

This endpoint allows you to retrieve the cup knock outs. You can use id from the seasons or leagues endpoint to get the wanted cup knock out tree.

Fields in rounds:

FieldExplanation
orderThe order of the round
descriptionThe description of the round
blocksThe blocks of the round
finishedIf the match is finished
orderThe order of the block
home_team_scoreThe score of the home team
away_team_scoreThe score of the away team
has_next_round_linkIf the match has next round
match_in_progressIf the match is in play
series_start_date_timestampThe start date of the match
automatic_progressionIf the match has automatic progression
participantsThe participants of the block (match)
team_idThe id of the team
winnerIf the team is winner of the block
orderThe order of the participants

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated after every finished match.
Recommended Calls: Limit calls to 1 per finished match.

Use Cases

Get cup knock out based on the id
https://football.sportdevs.com/cup-bracket?id=eq.{id}

Get cups based on the season_id
https://football.sportdevs.com/cup-bracket?season_id=eq.{season_id}

Get cups based on the league_id
https://football.sportdevs.com/cup-bracket?league_id=eq.{league_id}

Query Parameters
  • id integer

    Default value: eq.15

    The id of the cup bracket

  • season_id integer

    Default value: eq.1185

    The id of the season

  • league_id integer

    Default value: eq.106

    The id of the league

  • offset string

    Default value: 0

    Limiting and Pagination

  • limit string

    Default value: 50

    Limiting and Pagination

  • lang string

    Default value: en

    Multi-language

Responses

OK


Schema array
  • id integer

    The id of the cup bracket

    Note: This is a Primary Key.

  • name text

    The name of the cup bracket

  • current_round integer

    The last or the current round in the cup bracket

  • type integer

    The type of the cup bracket

  • season_id integer

    The id of the season

    Note: This is a Foreign Key to seasons.id.

  • season_name text

    The name of the season

  • league_id integer

    The id of the league

    Note: This is a Foreign Key to leagues.id.

  • league_name text

    The name of the league

  • league_hash_image character varying

    Possible values: <= 64 characters

    The name image of the league

  • rounds jsonb

    The rounds of the cup bracket

Loading...