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:

Field	Explanation
`order`	The order of the round
`description`	The description of the round
`blocks`	The blocks of the round
`finished`	If the match is finished
`order`	The order of the block
`home_team_score`	The score of the home team
`away_team_score`	The score of the away team
`has_next_round_link`	If the match has next round
`match_in_progress`	If the match is in play
`series_start_date_timestamp`	The start date of the match
`automatic_progression`	If the match has automatic progression
`participants`	The participants of the block (match)
`team_id`	The id of the team
`winner`	If the team is winner of the block
`order`	The 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://handball.sportdevs.com/cup-bracket?id=eq.{id}

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

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

Query Parameters

id integer
Default value: eq.2241
The id of the cup bracket
season_id integer
Default value: eq.33927
The id of the season
league_id integer
Default value: eq.7566
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

application/json

Schema
Example (from schema)

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

[
  {
    "id": 2241,
    "name": "Cup, Women",
    "current_round": 4,
    "type": 1,
    "season_id": 33927,
    "season_name": "Cup, Women 2014",
    "league_id": 7566,
    "league_name": "Cup, Women",
    "league_hash_image": "a36461ce124e0737e9efd896aea4298ee073a3310e03a7397e35601372c4a9fb",
    "rounds": [
      {
        "type": 2,
        "order": 3,
        "blocks": [
          {
            "order": 1,
            "matches": [
              12
            ],
            "finished": true,
            "participants": [
              {
                "order": 2,
                "winner": true,
                "team_id": 1736,
                "team_name": "Iuventa Michalovce",
                "team_hash_image": "920a2b1808c249a5f325003f321d3d78ce85dbac322399c713768d67aa703ef4"
              },
              {
                "order": 1,
                "winner": false,
                "team_id": 44162,
                "team_name": "Sporta Hlohovec",
                "team_hash_image": "31974a55296ca0d7eab8499101817463a961e400c710c16fbb4f69be86b28e4c"
              }
            ],
            "away_team_score": "44",
            "home_team_score": "16",
            "has_next_round_link": true,
            "automatic_progression": false,
            "series_start_date_timestamp": "2015-04-25T13:30:00+00:00"
          },
          {
            "order": 2,
            "matches": [
              13
            ],
            "finished": true,
            "participants": [
              {
                "order": 2,
                "winner": true,
                "team_id": 44073,
                "team_name": "HK Slovan Duslo Šaľa",
                "team_hash_image": "e2f73de189e0953fb8cb44c4c6578379a6dbaef20d3ebe4696fb273165179562"
              },
              {
                "order": 1,
                "winner": false,
                "team_id": 44169,
                "team_name": "HK Slávia ZDA Partizánske",
                "team_hash_image": "508d9a4ebb23b50008a66ce50e3d141f56035114cc4d5285ec64cafae851ae81"
              }
            ],
            "away_team_score": "36",
            "home_team_score": "18",
            "has_next_round_link": true,
            "automatic_progression": false,
            "series_start_date_timestamp": "2015-04-25T15:30:00+00:00"
          }
        ],
        "description": "Semifinals"
      },
      {
        "type": 4,
        "order": 2,
        "blocks": [
          {
            "order": 1,
            "matches": [
              4
            ],
            "finished": true,
            "participants": [
              {
                "order": 1,
                "winner": true,
                "team_id": 44162,
                "team_name": "Sporta Hlohovec",
                "team_hash_image": "31974a55296ca0d7eab8499101817463a961e400c710c16fbb4f69be86b28e4c"
              },
              {
                "order": 2,
                "winner": false,
                "team_id": 44185,
                "team_name": "SKP Piccard Senec",
                "team_hash_image": "0084fce084e137857a1529b5a50272332033702bfaa6066b68afd220eb65a075"
              }
            ],
            "away_team_score": "26",
            "home_team_score": "27",
            "has_next_round_link": true,
            "automatic_progression": false,
            "series_start_date_timestamp": "2014-09-16T16:00:00+00:00"
          },
          {
            "order": 4,
            "matches": [
              9
            ],
            "finished": true,
            "participants": [
              {
                "order": 2,
                "winner": true,
                "team_id": 61806,
                "team_name": "Handball Zlatna NA Ostrove",
                "team_hash_image": "1dd3189ac3285712db210f9cf4f65d1f7c609bb3f925ddb51f685f4ab2ddf226"
              },
              {
                "order": 1,
                "winner": false,
                "team_id": 44073,
                "team_name": "HK Slovan Duslo Šaľa",
                "team_hash_image": "e2f73de189e0953fb8cb44c4c6578379a6dbaef20d3ebe4696fb273165179562"
              }
            ],
            "away_team_score": "46",
            "home_team_score": "18",
            "has_next_round_link": true,
            "automatic_progression": false,
            "series_start_date_timestamp": "2014-09-16T16:00:00+00:00"
          },
          {
            "order": 3,
            "matches": [
              8
            ],
            "finished": true,
            "participants": [
              {
                "order": 2,
                "winner": true,
                "team_id": 44169,
                "team_name": "HK Slávia ZDA Partizánske",
                "team_hash_image": "508d9a4ebb23b50008a66ce50e3d141f56035114cc4d5285ec64cafae851ae81"
              },
              {
                "order": 1,
                "winner": false,
                "team_id": 61767,
                "team_name": "Topolcany",
                "team_hash_image": "171ded2584f322f15693fa7780ee42ecb8a91d7c84c4edcee79e54934e3f21f4"
              }
            ],
            "away_team_score": "32",
            "home_team_score": "27",
            "has_next_round_link": true,
            "automatic_progression": false,
            "series_start_date_timestamp": "2014-09-17T16:30:00+00:00"
          },
          {
            "order": 2,
            "matches": [
              6
            ],
            "finished": true,
            "participants": [
              {
                "order": 2,
                "winner": true,
                "team_id": 1736,
                "team_name": "Iuventa Michalovce",
                "team_hash_image": "920a2b1808c249a5f325003f321d3d78ce85dbac322399c713768d67aa703ef4"
              },
              {
                "order": 1,
                "winner": false,
                "team_id": 44156,
                "team_name": "Bemaco Presov",
                "team_hash_image": "056672e5c8a8ebd7f2e427c3da858c8bfcb062ca790ab092b3828286f50bf8de"
              }
            ],
            "away_team_score": "24",
            "home_team_score": "18",
            "has_next_round_link": true,
            "automatic_progression": false,
            "series_start_date_timestamp": "2014-09-17T16:00:00+00:00"
          }
        ],
        "description": "Quarterfinals"
      },
      {
        "type": 8,
        "order": 1,
        "blocks": [
          {
            "order": 1,
            "matches": [
              2
            ],
            "finished": true,
            "participants": [
              {
                "order": 1,
                "winner": true,
                "team_id": 44162,
                "team_name": "Sporta Hlohovec",
                "team_hash_image": "31974a55296ca0d7eab8499101817463a961e400c710c16fbb4f69be86b28e4c"
              },
              {
                "order": 2,
                "winner": false,
                "team_id": 61556,
                "team_name": "UDHK ŠG Nitra",
                "team_hash_image": "df40ee2f2e2b8d830a315e30799683e14fcb26a36945d34f520f4126b4f39575"
              }
            ],
            "away_team_score": "14",
            "home_team_score": "27",
            "has_next_round_link": true,
            "automatic_progression": false,
            "series_start_date_timestamp": "2014-09-06T12:00:00+00:00"
          },
          {
            "order": 2,
            "finished": true,
            "participants": [
              {
                "winner": true,
                "team_id": 44185,
                "team_name": "SKP Piccard Senec",
                "team_hash_image": "0084fce084e137857a1529b5a50272332033702bfaa6066b68afd220eb65a075"
              }
            ],
            "has_next_round_link": true,
            "automatic_progression": true
          },
          {
            "order": 7,
            "finished": true,
            "participants": [
              {
                "winner": true,
                "team_id": 44073,
                "team_name": "HK Slovan Duslo Šaľa",
                "team_hash_image": "e2f73de189e0953fb8cb44c4c6578379a6dbaef20d3ebe4696fb273165179562"
              }
            ],
            "has_next_round_link": true,
            "automatic_progression": true
          },
          {
            "order": 8,
            "finished": true,
            "participants": [
              {
                "winner": true,
                "team_id": 61806,
                "team_name": "Handball Zlatna NA Ostrove",
                "team_hash_image": "1dd3189ac3285712db210f9cf4f65d1f7c609bb3f925ddb51f685f4ab2ddf226"
              }
            ],
            "has_next_round_link": true,
            "automatic_progression": true
          },
          {
            "order": 5,
            "finished": true,
            "participants": [
              {
                "winner": true,
                "team_id": 61767,
                "team_name": "Topolcany",
                "team_hash_image": "171ded2584f322f15693fa7780ee42ecb8a91d7c84c4edcee79e54934e3f21f4"
              }
            ],
            "has_next_round_link": true,
            "automatic_progression": true
          },
          {
            "order": 6,
            "finished": true,
            "participants": [
              {
                "winner": true,
                "team_id": 44169,
                "team_name": "HK Slávia ZDA Partizánske",
                "team_hash_image": "508d9a4ebb23b50008a66ce50e3d141f56035114cc4d5285ec64cafae851ae81"
              }
            ],
            "has_next_round_link": true,
            "automatic_progression": true
          },
          {
            "order": 3,
            "finished": true,
            "participants": [
              {
                "winner": true,
                "team_id": 44156,
                "team_name": "Bemaco Presov",
                "team_hash_image": "056672e5c8a8ebd7f2e427c3da858c8bfcb062ca790ab092b3828286f50bf8de"
              }
            ],
            "has_next_round_link": true,
            "automatic_progression": true
          },
          {
            "order": 4,
            "finished": true,
            "participants": [
              {
                "winner": true,
                "team_id": 1736,
                "team_name": "Iuventa Michalovce",
                "team_hash_image": "920a2b1808c249a5f325003f321d3d78ce85dbac322399c713768d67aa703ef4"
              }
            ],
            "has_next_round_link": true,
            "automatic_progression": true
          }
        ],
        "description": "Qualification round 1"
      },
      {
        "type": 1,
        "order": 4,
        "blocks": [
          {
            "order": 1,
            "matches": [
              15
            ],
            "finished": true,
            "participants": [
              {
                "order": 2,
                "winner": false,
                "team_id": 44073,
                "team_name": "HK Slovan Duslo Šaľa",
                "team_hash_image": "e2f73de189e0953fb8cb44c4c6578379a6dbaef20d3ebe4696fb273165179562"
              },
              {
                "order": 1,
                "winner": true,
                "team_id": 1736,
                "team_name": "Iuventa Michalovce",
                "team_hash_image": "920a2b1808c249a5f325003f321d3d78ce85dbac322399c713768d67aa703ef4"
              }
            ],
            "away_team_score": "27",
            "home_team_score": "32",
            "has_next_round_link": false,
            "automatic_progression": false,
            "series_start_date_timestamp": "2015-04-26T08:30:00+00:00"
          }
        ],
        "description": "Final"
      }
    ]
  }
]

Cup Bracket​

Use Cases​

Cup Bracket

Use Cases