Football · Europe · Club competition
Champions League API from the league phase to the final
A Champions League API with live scores, the league-phase table, the knockout bracket and match statistics on league id 4409. Every season since 1992/93, the first played under the Champions League name, sits in the archive in the format it was played in.
- 35 seasons since 1992/93
- 36 clubs in the league phase
- League id 4409
- Knockout bracket in one call

UEFA Champions League
GET /v2/leagues/4409
- League id
4409- Category
- Europe
- Archive
- 35 seasons since 1992/93
- Teams
- 36 clubs in the league phase
- Live channel
league:4409
In the data
The Champions League in the API
What league id 4409 holds, and how its seasons are laid out.
Each season in its own format
The competition has changed shape more than once since 1992/93, and the data keeps every season as it was played. Seasons with a group stage hold one table per group, which group=all returns together. From 2024/25 a single league phase of 36 clubs makes one table: the top eight go straight to the round of 16, the next sixteen to a knockout play-off. /rounds names every stage, so passing a round's slug and prefix to /fixtures keeps a qualifying round apart from a league-phase matchday.
The bracket, ready to draw
/v2/leagues/4409/cup-trees returns the knockout stage as rounds of ties. Each tie carries the fixture ids of both legs, the aggregate score, the penalty shoot-out if there was one, the winner and the tie each side came through, so a bracket can be drawn without working out the pairings yourself. Places not yet decided wait as empty teams until the draw or the previous round fills them.
A whole matchday at once
On a league-phase night many matches kick off together. GET /v2/livescores?sport=football returns all of them in one call with score, clock and status current to the second, and GET /v2/fixtures?date=…&league=4409 gives the night's whole programme. On Business and Enterprise one WebSocket subscription to league:4409 pushes each goal, card and kick-off of every live match.
Endpoints
The calls behind a Champions League app
Each takes league id 4409, a season id from its seasons list, or a match or team id from those. Every row opens its page in the docs.
- GET
/v2/leagues/{id}/seasonsSeasonsEvery season since 1992/93, with the season ids the other calls take.All plans - GET
/v2/leagues/{id}/standingsStandingsThe league-phase table, or every group table of an older season at once.All plans - GET
/v2/leagues/{id}/roundsRoundsEach stage of a season, from qualifying to the final, the current one flagged.All plans - GET
/v2/leagues/{id}/cup-treesCup treesThe knockout bracket: ties, both legs, aggregate scores and shoot-outs.All plans - GET
/v2/fixturesFixtures by dateOne night's matches of the competition, in a single request.All plans - GET
/v2/fixtures/{id}/lineupsLineupsFormations and both squads, every player with a match rating.All plans - GET
/v2/leagues/{id}/top-playersTop playersThe competition's leaderboards for a season.Pro and up - GET
/v2/teams/{id}/trophiesTrophiesEverything a club has won, typed as domestic or international.All plans
First request
The Champions League in three calls
Every call starts from the league id, 4409. The seasons list gives the season ids, newest first, and the season id is what the tables, rounds, leaderboards and statistics ask for.
The answers use the usual { data, meta } envelope and the same field names as every other football competition, so the code works unchanged for the next league you add.
# Every season, newest first, with its season id
curl "https://api.datasportsapi.com/v2/leagues/4409/seasons" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
# Every table of the season (one in the league phase)
curl "https://api.datasportsapi.com/v2/leagues/4409/standings?season={seasonId}&group=all" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
# The knockout bracket
curl "https://api.datasportsapi.com/v2/leagues/4409/cup-trees?season={seasonId}" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"{ "data": {
"id": 4409, "name": "UEFA Champions League", "sport": "football",
"category": "Europe", "country": null,
"tier": null, "gender": "male",
"lowerDivisions": [],
…
} }History
How much of the Champions League each plan reads
The archive goes back to 1992/93. Each plan reads back a set time from today; nothing live or upcoming is ever held back.
| Topic | History | What it covers of the Champions League |
|---|---|---|
| Free | Last 7 days | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 7 days. |
| Starter | Last 30 days | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 30 days. |
| Pro | Last 6 months | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 6 months. |
| Business | Last 12 months | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 12 months. |
| Enterprise | Full history | The whole archive: 35 seasons since 1992/93. |
Questions
Champions League API, answered
Anything else? The full FAQ covers quota, plans and the data in general.
Does the API handle the 36-club league phase?
Yes. From 2024/25 the league phase is one table of 36 clubs, served by /v2/leagues/4409/standings like any league table, with each club's form and the zone its place leads to. Seasons played with groups keep one table per group; add group=all to get them together.
How do I draw the knockout bracket?
Ask /v2/leagues/4409/cup-trees?season= for the season. The answer is nested as rounds, then ties, then the two sides of each tie with their aggregate score, shoot-out goals and the tie they came from, plus the fixture ids of every leg for the details. That is everything a bracket needs, in the right order.
Is the old European Cup included, and the other UEFA competitions?
This competition's archive starts with 1992/93, the first season under the Champions League name; earlier European Cup seasons are not part of it. The Europa League and the Conference League are separate competitions with their own ids, and search finds them by name.
How far back does Champions League data go?
To 1992/93: the archive holds 35 seasons of the Champions League. How far back a key can read is set by its plan, counted back from today: Free 7 days, Starter 30 days, Pro 6 months, Business 12 months, and Enterprise the whole archive. Live and upcoming matches, and the table and statistics of a season still being played, are open on every plan.
Can I follow Champions League matches live on the free plan?
Yes. Live and upcoming matches are never held back by a plan, so a Free key follows every Champions League match in play through /v2/livescores or /v2/fixtures/{id}, with score, status and clock current to the second, within the plan's request quota. On Business and Enterprise, the WebSocket channel league:4409 pushes every change instead.
Keep reading
Other competitions
Premier League APILeague id 195828: live scores, the table, xG and every season since 1992/93.
La Liga APILeague id 4408: Spain's top flight, head-to-head records and every season since 1969/70.
Serie A APILeague id 195910: Italy's top flight, venues and the longest big-five archive, back to 1965/66.
Bundesliga APILeague id 195937: Germany's 18 clubs, the team of the week and every season since 1970/71.
Ligue 1 APILeague id 195793: France's top flight, every player's statistics and seasons since 1970/71.
World Cup APILeague id 195843: all 23 tournaments from 1930 to 2026, group tables and the bracket.
Süper Lig APILeague id 172801: Turkey's top division, its referees on record and seasons back to 1980/81.
MLS APILeague id 6540: 30 clubs, two conference tables and calendar-year seasons since 2008.
Europa League APILeague id 43443: one 36-club table, knockout ties on aggregate and seasons since 2009/10.
NBA APILeague id 198277: box scores, play-by-play, shot charts, the draft and live player tracking.
NFL APILeague id 201295: down and distance live, win probability, the draft and seasons back to 1920.
NHL APILeague id 201302: conference and division tables, shot maps by strength, the three stars and playoff series.
MLB APILeague id 201220: the live count, every at-bat and pitch, umpire crews and ballpark weather.
IPL APILeague id 195830: full scorecards, every ball with wagon wheel and pitch map, and seasons since 2013.
Everything in the football data Sports statistics API Live scores API
Build on the Champions League today.
1,000 free requests a day during the beta. No card, no sales call.