UEFA CHAMPIONS LEAGUE API

Welcome to the BALLDONTLIE UEFA CHAMPIONS LEAGUE API. This API contains data from 2010-current. An API key is required. You can obtain an API key by creating a free account on our website. Read the authentication section to learn how to use the API key.

Take a look at our other APIs.

Join us on discord.

AI-Powered Integration

Using the OpenAPI Specification with AI

Our complete OpenAPI specification allows AI assistants to automatically understand and interact with our API. Simply share the spec URL with your AI assistant and describe what you want to build—the AI will handle the technical implementation.

Getting Started with AI:

Copy this URL: https://www.balldontlie.io/openapi.yml
Share it with your preferred AI assistant (ChatGPT, Claude, Gemini, etc.)
Tell the AI what you want to build (e.g., "Create a dashboard showing this week's Champions League matches")
The AI will read the OpenAPI spec and write the code for you

Example prompts to try:

"Using the OpenAPI spec at https://www.balldontlie.io/openapi.yml, show me the Champions League standings"
"Read the BALLDONTLIE OpenAPI spec and create a Python script that fetches this week's Champions League matches"
"Help me understand the available Champions League endpoints from this OpenAPI spec: https://www.balldontlie.io/openapi.yml"

This makes it incredibly easy for non-technical users, analysts, and researchers to leverage our sports data without needing to learn programming from scratch.

Google Sheets Integration

Our Google Sheets integration lets you access all the same data available through our API using simple spreadsheet formulas. Perfect for fantasy sports tracking, betting analysis, and sports research.

Quick Start:

Get your API key from app.balldontlie.io
Copy our Google Sheets script
Paste it into your Google Sheet (Extensions > Apps Script)
Start using functions in your cells

Example functions:

=BDL_UCL_TEAMS() - Get all teams
=BDL_UCL_PLAYERS("search") - Search for players
=BDL_UCL_MATCHES("2026-01-27") - Get matches by date
=BDL_UCL_STANDINGS(2025) - Get standings

For full setup instructions and the complete list of 150+ functions, see our Google Sheets Integration Guide.

Account Tiers

There are three different account tiers which provide you access to different types of data. Visit our website to create an account for free.

Paid tiers do not apply across sports. The tier you purchase for Champions League will not automatically be applied to other sports. You can purchase the ALL-ACCESS ($299.99/mo) tier to get access to every endpoint for every sport.

Read the table below to see the breakdown.

Endpoint	Free	ALL-STAR	GOAT
Teams	Yes	Yes	Yes
Players	Yes	Yes	Yes
Rosters	Yes	Yes	Yes
Standings	Yes	Yes	Yes
Matches	No	Yes	Yes
Match Events	No	Yes	Yes
Match Lineups	No	Yes	Yes
Player Match Stats	No	No	Yes
Team Match Stats	No	No	Yes
Betting Odds	No	No	Yes
Player Props	No	No	Yes
Futures Odds	No	No	Yes

The feature breakdown per tier is shown in the table below.

Tier	Requests / Min	$USD / mo.
GOAT	600	39.99
ALL-STAR	60	9.99
Free	5	0

Authentication

curl "api_endpoint_here" -H "Authorization: YOUR_API_KEY"

const response = await fetch("api_endpoint_here", {
  headers: {
    "Authorization": "YOUR_API_KEY"
  }
});
const data = await response.json();

import requests

response = requests.get(
    "api_endpoint_here",
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

BALLDONTLIE uses API keys to allow access to the API. You can obtain an API key by creating a free account at our website

We expect the API key to be included in all API requests to the server in a header that looks like the following:

Authorization: YOUR_API_KEY

You must replace YOUR_API_KEY with your personal API key.

Pagination

This API uses cursor based pagination rather than limit/offset. Endpoints that support pagination will send back responses with a meta key that looks like what is displayed on the right.

{
  "meta": {
    "next_cursor": 90,
    "per_page": 25
  }
}

You can use per_page to specify the maximum number of results. It defaults to 25 and doesn't allow values larger than 100.

You can use next_cursor to get the next page of results. Specify it in the request parameters like this: ?cursor=NEXT_CURSOR.

Errors

The API uses the following error codes:

Error Code	Meaning
401	Unauthorized - You either need an API key or your account tier does not have access to the endpoint.
400	Bad Request -- The request is invalid. The request parameters are probably incorrect.
404	Not Found -- The specified resource could not be found.
406	Not Acceptable -- You requested a format that isn't json.
429	Too Many Requests -- You're rate limited.
500	Internal Server Error -- We had a problem with our server. Try again later.
503	Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

Teams

Get All Teams

curl "https://api.balldontlie.io/ucl/v1/teams" \
  -H "Authorization: YOUR_API_KEY"

# With optional season parameter
curl "https://api.balldontlie.io/ucl/v1/teams?season=2024" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/teams",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

// With optional season parameter
const response2024 = await fetch(
  "https://api.balldontlie.io/ucl/v1/teams?season=2024",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data2024 = await response2024.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/teams",
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

# With optional season parameter
response_2024 = requests.get(
    "https://api.balldontlie.io/ucl/v1/teams",
    params={"season": 2024},
    headers={"Authorization": "YOUR_API_KEY"}
)
data_2024 = response_2024.json()

{
  "data": [
    {
      "id": 2,
      "name": "Arsenal",
      "short_name": "Arsenal",
      "abbreviation": "ARS",
      "location": "Arsenal"
    },
    {
      "id": 24,
      "name": "Bayern Munich",
      "short_name": "Bayern",
      "abbreviation": "MUN",
      "location": "Bayern Munich"
    },
    {
      "id": 73,
      "name": "Paris Saint-Germain",
      "short_name": "PSG",
      "abbreviation": "PSG",
      "location": "Paris Saint-Germain"
    },
    {
      "id": 13,
      "name": "Manchester City",
      "short_name": "Man City",
      "abbreviation": "MNC",
      "location": "Manchester City"
    },
    {
      "id": 53,
      "name": "Real Madrid",
      "short_name": "Real Madrid",
      "abbreviation": "RMA",
      "location": "Real Madrid"
    },
    {
      "id": 42,
      "name": "Barcelona",
      "short_name": "Barcelona",
      "abbreviation": "BAR",
      "location": "Barcelona"
    },
    ...
  ]
}

This endpoint retrieves all teams participating in the Champions League.

HTTP Request

GET https://api.balldontlie.io/ucl/v1/teams

Query Parameters

Parameter	Required	Description
season	false	Filter by season year. Defaults to the current season if omitted.

Players

Get All Players

curl "https://api.balldontlie.io/ucl/v1/players?per_page=3" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/players?per_page=3",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/players",
    params={"per_page": 3},
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "id": 1675,
      "first_name": "Kylian",
      "last_name": "Mbappé",
      "display_name": "Kylian Mbappé",
      "short_name": "K Mbappé",
      "date_of_birth": "1998-12-20",
      "age": 27,
      "height": "5' 10\"",
      "weight": "163 lbs",
      "citizenship": "France",
      "team_ids": [53]
    },
    {
      "id": 359,
      "first_name": "Mohamed",
      "last_name": "Salah",
      "display_name": "Mohamed Salah",
      "short_name": "M Salah",
      "date_of_birth": "1992-06-15",
      "age": 33,
      "height": "5' 9\"",
      "weight": "157 lbs",
      "citizenship": "Egypt",
      "team_ids": [12]
    },
    {
      "id": 1671,
      "first_name": "Jude",
      "last_name": "Bellingham",
      "display_name": "Jude Bellingham",
      "short_name": "J Bellingham",
      "date_of_birth": "2003-06-29",
      "age": 22,
      "height": "6' 1\"",
      "weight": "163 lbs",
      "citizenship": "England",
      "team_ids": [53]
    }
  ],
  "meta": {
    "next_cursor": 1671,
    "per_page": 3
  }
}

This endpoint retrieves all players from teams participating in the Champions League. The team_ids array contains the IDs of all teams the player is associated with.

HTTP Request

GET https://api.balldontlie.io/ucl/v1/players

Query Parameters

Parameter	Required	Description
cursor	false	The cursor for pagination
per_page	false	Number of results per page (max 100)
team_ids	false	Filter by team IDs (array)
search	false	Search players by name

Rosters

Get Team Roster

curl "https://api.balldontlie.io/ucl/v1/rosters?team_id=12" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/rosters?team_id=12",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/rosters",
    params={"team_id": 12},
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "team_id": 12,
      "player": {
        "id": 353,
        "first_name": "Virgil",
        "last_name": "van Dijk",
        "display_name": "Virgil van Dijk",
        "short_name": "V van Dijk",
        "date_of_birth": "1991-07-08",
        "age": 34,
        "height": "6' 5\"",
        "weight": "203 lbs",
        "citizenship": "Netherlands"
      },
      "season": 2025,
      "jersey_number": "4",
      "position": "Defender",
      "position_abbreviation": "D",
      "is_active": true
    },
    {
      "team_id": 12,
      "player": {
        "id": 359,
        "first_name": "Mohamed",
        "last_name": "Salah",
        "display_name": "Mohamed Salah",
        "short_name": "M Salah",
        "date_of_birth": "1992-06-15",
        "age": 33,
        "height": "5' 9\"",
        "weight": "157 lbs",
        "citizenship": "Egypt"
      },
      "season": 2025,
      "jersey_number": "11",
      "position": "Forward",
      "position_abbreviation": "F",
      "is_active": true
    },
    {
      "team_id": 12,
      "player": {
        "id": 350,
        "first_name": "Alisson",
        "last_name": "Becker",
        "display_name": "Alisson Becker",
        "short_name": "A Becker",
        "date_of_birth": "1992-10-02",
        "age": 33,
        "height": "6' 4\"",
        "weight": "201 lbs",
        "citizenship": "Brazil"
      },
      "season": 2025,
      "jersey_number": "1",
      "position": "Goalkeeper",
      "position_abbreviation": "G",
      "is_active": true
    }
  ]
}

This endpoint retrieves the roster for a specific team participating in the Champions League.

HTTP Request

GET https://api.balldontlie.io/ucl/v1/rosters

Query Parameters

Parameter	Required	Description
team_id	true	The team ID to get roster for
season	false	Filter by season

Standings

Get Standings

curl "https://api.balldontlie.io/ucl/v1/standings" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/standings",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/standings",
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "team": {
        "id": 2,
        "name": "Arsenal",
        "short_name": "Arsenal",
        "abbreviation": "ARS",
        "location": "Arsenal"
      },
      "season": 2025,
      "rank": 1,
      "rank_change": 0,
      "group_name": "League Phase",
      "note": "Qualifies for round of 16",
      "games_played": 6,
      "wins": 6,
      "losses": 0,
      "draws": 0,
      "points": 18,
      "goals_for": 17,
      "goals_against": 1,
      "goal_differential": 16,
      "points_per_game": null
    },
    {
      "team": {
        "id": 24,
        "name": "Bayern Munich",
        "short_name": "Bayern",
        "abbreviation": "MUN",
        "location": "Bayern Munich"
      },
      "season": 2025,
      "rank": 2,
      "rank_change": 0,
      "group_name": "League Phase",
      "note": "Qualifies for round of 16",
      "games_played": 6,
      "wins": 5,
      "losses": 1,
      "draws": 0,
      "points": 15,
      "goals_for": 18,
      "goals_against": 7,
      "goal_differential": 11,
      "points_per_game": null
    },
    {
      "team": {
        "id": 73,
        "name": "Paris Saint-Germain",
        "short_name": "PSG",
        "abbreviation": "PSG",
        "location": "Paris Saint-Germain"
      },
      "season": 2025,
      "rank": 3,
      "rank_change": 0,
      "group_name": "League Phase",
      "note": "Qualifies for round of 16",
      "games_played": 6,
      "wins": 4,
      "losses": 1,
      "draws": 1,
      "points": 13,
      "goals_for": 19,
      "goals_against": 8,
      "goal_differential": 11,
      "points_per_game": null
    },
    ...
  ]
}

This endpoint retrieves the current Champions League standings (League Phase).

HTTP Request

GET https://api.balldontlie.io/ucl/v1/standings

Query Parameters

Parameter	Required	Description
season	false	Filter by season

Matches

Get All Matches

curl "https://api.balldontlie.io/ucl/v1/matches?per_page=5" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/matches?per_page=5",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/matches",
    params={"per_page": 5},
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "id": 3035,
      "season": 2025,
      "home_team_id": 40,
      "away_team_id": 73,
      "date": "2025-12-10T20:00:00.000Z",
      "name": "Paris Saint-Germain at Athletic Club",
      "short_name": "PSG @ ATH",
      "status": "STATUS_FULL_TIME",
      "status_detail": "FT",
      "home_score": 0,
      "away_score": 0,
      "venue_name": "San Mames",
      "venue_city": "Bilbao",
      "attendance": 51772
    },
    ...
  ],
  "meta": {
    "next_cursor": 3030,
    "per_page": 5
  }
}

This endpoint retrieves all Champions League matches.

HTTP Request

GET https://api.balldontlie.io/ucl/v1/matches

Query Parameters

Parameter	Required	Description
cursor	false	The cursor for pagination
per_page	false	Number of results per page (max 100)
seasons	false	Filter by seasons (array)
team_ids	false	Filter by team IDs (array)
start_date	false	Filter matches on or after this date
end_date	false	Filter matches on or before this date
dates	false	Filter by specific dates (array)

Match Events

Get Match Events

curl "https://api.balldontlie.io/ucl/v1/match_events?match_ids[]=3035" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/match_events?match_ids[]=3035",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/match_events",
    params={"match_ids[]": 3035},
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "id": 35650,
      "match_id": 3035,
      "team_id": 40,
      "event_type": "yellow_card",
      "event_time": 27,
      "period": 1,
      "player": {
        "id": 1257,
        "first_name": "Mikel",
        "last_name": "Jauregizar",
        "display_name": "Mikel Jauregizar",
        "short_name": "M Jauregizar",
        "date_of_birth": "2003-11-13",
        "age": 22,
        "height": "5' 10\"",
        "weight": "161 lbs",
        "citizenship": "Spain"
      },
      "secondary_player": null,
      "goal_type": null,
      "is_own_goal": false
    },
    {
      "id": 35654,
      "match_id": 3035,
      "team_id": 73,
      "event_type": "yellow_card",
      "event_time": 30,
      "period": 1,
      "player": {
        "id": 2224,
        "first_name": "Warren",
        "last_name": "Zaire-Emery",
        "display_name": "Warren Zaire-Emery",
        "short_name": "W Zaire-Emery",
        "date_of_birth": "2006-03-08",
        "age": 19,
        "height": "5' 10\"",
        "weight": "150 lbs",
        "citizenship": "France"
      },
      "secondary_player": null,
      "goal_type": null,
      "is_own_goal": false
    },
    ...
  ]
}

This endpoint retrieves events (goals, cards, substitutions) for specific matches.

HTTP Request

GET https://api.balldontlie.io/ucl/v1/match_events

Query Parameters

Parameter	Required	Description
match_ids	true	Array of match IDs to get events for
cursor	false	The cursor for pagination
per_page	false	Number of results per page (max 100)

Match Lineups

Get Match Lineups

curl "https://api.balldontlie.io/ucl/v1/match_lineups?match_ids[]=3035" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/match_lineups?match_ids[]=3035",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/match_lineups",
    params={"match_ids[]": 3035},
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "match_id": 3035,
      "team_id": 73,
      "player": {
        "id": 2223,
        "first_name": "Bradley",
        "last_name": "Barcola",
        "display_name": "Bradley Barcola",
        "short_name": "B Barcola",
        "date_of_birth": "2002-09-02",
        "age": 23,
        "height": "6' 0\"",
        "weight": "161 lbs",
        "citizenship": "France"
      },
      "is_starter": true,
      "position": "Right Forward",
      "position_abbreviation": "RF",
      "formation_position": "10",
      "jersey_number": null
    },
    {
      "match_id": 3035,
      "team_id": 73,
      "player": {
        "id": 2213,
        "first_name": "Khvicha",
        "last_name": "Kvaratskhelia",
        "display_name": "Khvicha Kvaratskhelia",
        "short_name": "K Kvaratskhelia",
        "date_of_birth": "2001-02-12",
        "age": 24,
        "height": "6' 0\"",
        "weight": "168 lbs",
        "citizenship": "Georgia"
      },
      "is_starter": true,
      "position": "Left Forward",
      "position_abbreviation": "LF",
      "formation_position": "11",
      "jersey_number": null
    },
    {
      "match_id": 3035,
      "team_id": 73,
      "player": {
        "id": 2212,
        "first_name": "Marquinhos",
        "last_name": null,
        "display_name": "Marquinhos",
        "short_name": "Marquinhos",
        "date_of_birth": "1994-05-14",
        "age": 31,
        "height": "6' 0\"",
        "weight": "163 lbs",
        "citizenship": "Brazil"
      },
      "is_starter": true,
      "position": "Center Right Defender",
      "position_abbreviation": "CD-R",
      "formation_position": "5",
      "jersey_number": null
    },
    ...
  ]
}

This endpoint retrieves the lineups for specific matches.

HTTP Request

GET https://api.balldontlie.io/ucl/v1/match_lineups

Query Parameters

Parameter	Required	Description
match_ids	true	Array of match IDs to get lineups for
cursor	false	The cursor for pagination
per_page	false	Number of results per page (max 100)

Player Match Stats

Get Player Match Stats

curl "https://api.balldontlie.io/ucl/v1/player_match_stats?match_ids[]=3035" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/player_match_stats?match_ids[]=3035",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/player_match_stats",
    params={"match_ids[]": 3035},
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "match_id": 3035,
      "player_id": 1243,
      "team_id": 40,
      "appearances": 1,
      "goals": 0,
      "assists": 0,
      "shots_total": 3,
      "shots_on_target": null,
      "fouls_committed": 3,
      "fouls_suffered": null,
      "offsides": null,
      "saves": null,
      "yellow_cards": 1,
      "red_cards": 0,
      "own_goals": 0
    },
    {
      "match_id": 3035,
      "player_id": 2214,
      "team_id": 73,
      "appearances": 1,
      "goals": 0,
      "assists": 0,
      "shots_total": 4,
      "shots_on_target": 2,
      "fouls_committed": null,
      "fouls_suffered": 2,
      "offsides": 1,
      "saves": null,
      "yellow_cards": 0,
      "red_cards": 0,
      "own_goals": 0
    },
    ...
  ],
  "meta": {
    "per_page": 25
  }
}

This endpoint retrieves player statistics for specific matches.

HTTP Request

GET https://api.balldontlie.io/ucl/v1/player_match_stats

Query Parameters

Parameter	Required	Description
match_ids	true	Array of match IDs to get stats for
cursor	false	The cursor for pagination
per_page	false	Number of results per page (max 100)

Team Match Stats

Get Team Match Stats

curl "https://api.balldontlie.io/ucl/v1/team_match_stats?match_ids[]=3035" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/team_match_stats?match_ids[]=3035",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/team_match_stats",
    params={"match_ids[]": 3035},
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "match_id": 3035,
      "team_id": 40,
      "possession_pct": 27.6,
      "shots": 9,
      "shots_on_target": 1,
      "fouls": 21,
      "yellow_cards": 3,
      "red_cards": 0,
      "corners": null,
      "passes": 251,
      "pass_accuracy_pct": null
    },
    {
      "match_id": 3035,
      "team_id": 73,
      "possession_pct": 72.4,
      "shots": 18,
      "shots_on_target": 5,
      "fouls": 4,
      "yellow_cards": 1,
      "red_cards": 0,
      "corners": null,
      "passes": 684,
      "pass_accuracy_pct": null
    }
  ],
  "meta": {
    "per_page": 25
  }
}

This endpoint retrieves team statistics for specific matches.

HTTP Request

GET https://api.balldontlie.io/ucl/v1/team_match_stats

Query Parameters

Parameter	Required	Description
match_ids	true	Array of match IDs to get stats for
cursor	false	The cursor for pagination
per_page	false	Number of results per page (max 100)

Betting Odds

Get Betting Odds

curl "https://api.balldontlie.io/ucl/v1/odds?per_page=5" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/odds?per_page=5",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/odds",
    params={"per_page": 5},
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "id": 40973803,
      "match_id": 3042,
      "vendor": "draftkings",
      "moneyline_home_odds": 195,
      "moneyline_away_odds": 120,
      "moneyline_draw_odds": 260,
      "updated_at": "2025-12-23T16:27:25.870Z"
    },
    {
      "id": 40973796,
      "match_id": 3043,
      "vendor": "draftkings",
      "moneyline_home_odds": 300,
      "moneyline_away_odds": -140,
      "moneyline_draw_odds": 330,
      "updated_at": "2025-12-23T16:27:25.870Z"
    },
    {
      "id": 40973802,
      "match_id": 3044,
      "vendor": "draftkings",
      "moneyline_home_odds": 225,
      "moneyline_away_odds": 100,
      "moneyline_draw_odds": 280,
      "updated_at": "2025-12-23T16:27:25.870Z"
    },
    ...
  ],
  "meta": {
    "next_cursor": 40973809,
    "per_page": 5
  }
}

This endpoint retrieves betting odds for Champions League matches. Odds include moneyline odds for home, away, and draw outcomes.

Available Vendors:

Vendor	Description
caesars	Caesars Sportsbook
draftkings	DraftKings
fanduel	FanDuel
polymarket	Polymarket (prediction market)

HTTP Request

GET https://api.balldontlie.io/ucl/v1/odds

Query Parameters

Parameter	Required	Description
cursor	false	The cursor for pagination
per_page	false	Number of results per page (max 100)
match_ids	false	Filter by match IDs (array)

Player Props

The Player Props API provides real-time player prop betting odds for Champions League matches. Player props allow betting on individual player performances such as goals, assists, shots on target, saves, and more.

Market Types

The API supports two market types:

over_under: Traditional over/under markets where users can bet on whether a player will go over or under a specific line value
milestone: Milestone markets where users bet on whether a player will reach a specific achievement (e.g., anytime goal scorer)

Get Player Props

curl "https://api.balldontlie.io/ucl/v1/odds/player_props?match_id=3042" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/odds/player_props?match_id=3042",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/odds/player_props",
    params={"match_id": 3042},
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "id": 399789241,
      "match_id": 3042,
      "player_id": 519,
      "vendor": "caesars",
      "prop_type": "anytime_goal",
      "line_value": "2",
      "market": {
        "type": "milestone",
        "odds": 340
      },
      "updated_at": "2025-12-07T17:01:50.442Z"
    },
    ...
  ]
}

This endpoint retrieves player prop betting odds for a specific Champions League match. The match_id parameter is required.

Available Vendors:

Vendor	Description
caesars	Caesars Sportsbook
draftkings	DraftKings
fanduel	FanDuel

HTTP Request

GET https://api.balldontlie.io/ucl/v1/odds/player_props

Query Parameters

Parameter	Required	Description
match_id	true	The match ID to retrieve player props for
player_id	false	Filter props for a specific player
prop_type	false	Filter by prop type. See supported prop types below.
vendors	false	Filter by specific sportsbook vendors. This should be an array: `?vendors[]=draftkings&vendors[]=fanduel`

Supported Prop Types

The following prop_type values are supported:

Prop Type	Description
anytime_goal	Score a goal anytime in match
assists	Total assists
first_goal	Score the first goal of match
first_half_goal	Score a goal in the first half
goals_assists	Combined goals and assists
header_goal	Score a goal with a header
last_goal	Score the last goal of match
outside_box_goal	Score from outside the box
saves	Total saves (goalkeepers)
second_half_goal	Score a goal in the second half
shots	Total shots
shots_on_target	Total shots on target
tackles	Total tackles

Note: The actual prop types available may vary by match and sportsbook vendor.

Futures Odds

The Futures Odds API provides odds for tournament-level outcomes like which team will win the Champions League, reach the final, or finish in the top 8.

Market Types

The API supports several market types:

Market Type	Description
outright	Odds to win the Champions League
to_reach_final	Odds to reach the final
top_8_finish	Odds to finish in the top 8
finish_bottom	Odds to finish at the bottom
top_goalscorer	Odds to be the top goalscorer

Get Futures Odds

curl "https://api.balldontlie.io/ucl/v1/odds/futures" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/ucl/v1/odds/futures",
  {
    headers: { "Authorization": "YOUR_API_KEY" }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/ucl/v1/odds/futures",
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "id": 7085788,
      "market_type": "outright",
      "market_name": "Winner",
      "subject": {
        "id": 53,
        "name": "Real Madrid",
        "short_name": "Real Madrid",
        "abbreviation": "RMA",
        "location": "Real Madrid"
      },
      "vendor": "caesars",
      "american_odds": 25000,
      "decimal_odds": 251,
      "updated_at": "2025-12-23T12:26:24.367Z"
    },
    {
      "id": 6720258,
      "market_type": "outright",
      "market_name": "Winner",
      "subject": {
        "id": 53,
        "name": "Real Madrid",
        "short_name": "Real Madrid",
        "abbreviation": "RMA",
        "location": "Real Madrid"
      },
      "vendor": "fanduel",
      "american_odds": 17500,
      "decimal_odds": 176,
      "updated_at": "2025-12-23T12:26:29.424Z"
    },
    {
      "id": 7085856,
      "market_type": "top_8_finish",
      "market_name": "Top 8 Finish",
      "subject": {
        "id": 1501,
        "name": "Real Valladolid",
        "short_name": null,
        "abbreviation": null,
        "location": null
      },
      "vendor": "caesars",
      "american_odds": 150,
      "decimal_odds": 2.5,
      "updated_at": "2025-12-23T12:26:29.894Z"
    }
  ]
}

This endpoint retrieves futures odds for the Champions League including outright winner odds, top 8 finish odds, and more.

Available Vendors:

Vendor	Description
caesars	Caesars Sportsbook
draftkings	DraftKings
fanduel	FanDuel

HTTP Request

GET https://api.balldontlie.io/ucl/v1/odds/futures