Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Leagues

Cup trees

GET

/v2/leagues/{id}/cup-trees

All plans

View as MarkdownTry in Playground →

A season’s knockout brackets (the knockout phase of a cup in football and other sports, a playoff tree, a tennis draw), nested as rounds, then ties, then each tie’s two participants (team, seed, winner, score), then DataSportsAPI fixture ids.

score is the tie result as our data source reports it — aggregate goals across both legs in football, series wins in basketball and ice hockey, sets in tennis — and penalties holds shoot-out goals. fromBlock gives the order of the previous-round tie the participant advanced from. A null team marks a placeholder slot (“winner of QF 1”), and matchCount 0 marks a bye. Load the individual matches with /v2/fixtures/{id}. Seasons without a knockout phase return an empty array.

Parameters

id

pathrequired

league id issued by DataSportsAPI, a positive integer

season

queryrequired

season id, as listed by /v2/leagues/{id}/seasons

Response

data
CupTree[]
meta
season, count
errors
400 bad_request — season is absent or invalid403 history_not_in_plan — your plan’s history window begins after this season ended404 not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/leagues/{id}/cup-trees?season=…"
Example
{ "data": [ { "name": "CONMEBOL Libertadores 2026, Knockout stage", "currentRound": 3, "rounds": [ …,
    { "order": 3, "name": "Semifinals", "blocks": [
      { "order": 1, "finished": true, "inProgress": false, "startTime": "2026-10-16T00:30:00.000Z",
        "matchCount": 2, "fixtureIds": [789, 790], "automaticProgression": false, "venue": null,
        "home": { "team": { "id": 11, "name": "Estudiantes de La Plata", "slug": "estudiantes-de-la-plata", "shortName": "Estudiantes", "code": "ELP", "image": "…" },
                  "seed": null, "winner": true, "score": 0, "penalties": 3, "fromBlock": 1 },
        "away": { "team": { "id": 12, "name": "Flamengo", … }, "seed": null, "winner": false, "score": 0, "penalties": 2, "fromBlock": 2 } }, … ] }, … ] } ],
  "meta": { "season": 87760, "count": 1 } }