Cup trees
GET
/
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
idpathrequired
league id issued by DataSportsAPI, a positive integer
seasonqueryrequired
season id, as listed by /v2/leagues/{id}/seasons
Response
- data
CupTree[]- meta
- season, count
- errors
- 400
bad_request— season is absent or invalid403history_not_in_plan— your plan’s history window begins after this season ended404not_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 } }