Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab

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.

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"
GET /v2/leagues/4409 · trimmed
{ "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.

TopicHistoryWhat it covers of the Champions League
FreeLast 7 daysLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 7 days.
StarterLast 30 daysLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 30 days.
ProLast 6 monthsLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 6 months.
BusinessLast 12 monthsLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 12 months.
EnterpriseFull historyThe 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

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.