PREMIER LEAGUE API V2

Welcome to the BALLDONTLIE PREMIER LEAGUE API V2. 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 Premier 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 how to get Arsenal's current roster"
"Read the BALLDONTLIE OpenAPI spec and create a Python script that fetches this week's Premier League matches"
"Help me understand the available Premier 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.

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 Premier 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
Rosters	Yes	Yes	Yes
Players	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

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 "https://api.balldontlie.io/epl/v2/teams" \
  -H "Authorization: YOUR_API_KEY"

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

import requests

response = requests.get(
    "https://api.balldontlie.io/epl/v2/teams",
    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/epl/v2/teams" \
  -H "Authorization: YOUR_API_KEY"

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

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

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

import requests

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

# With optional season parameter
response_2024 = requests.get(
    "https://api.balldontlie.io/epl/v2/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": 13,
      "name": "Manchester City",
      "short_name": "Man City",
      "abbreviation": "MNC",
      "location": "Manchester City"
    },
    {
      "id": 12,
      "name": "Liverpool",
      "short_name": "Liverpool",
      "abbreviation": "LIV",
      "location": "Liverpool"
    },
    {
      "id": 7,
      "name": "Chelsea",
      "short_name": "Chelsea",
      "abbreviation": "CHE",
      "location": "Chelsea"
    },
    ...
  ]
}

This endpoint retrieves all teams.

HTTP Request

GET https://api.balldontlie.io/epl/v2/teams

Query Parameters

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

Rosters

Get Team Roster

curl "https://api.balldontlie.io/epl/v2/rosters?team_id=2" \
  -H "Authorization: YOUR_API_KEY"

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

import requests

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

{
  "data": [
    {
      "team_id": 2,
      "player": {
        "id": 33,
        "first_name": "William",
        "last_name": "Saliba",
        "display_name": "William Saliba",
        "short_name": "W Saliba",
        "date_of_birth": "2001-03-24",
        "age": 24,
        "height": "6' 4\"",
        "weight": "203 lbs",
        "citizenship": "France"
      },
      "season": 2025,
      "jersey_number": "2",
      "position": "Defender",
      "position_abbreviation": "D",
      "is_active": true
    },
    {
      "team_id": 2,
      "player": {
        "id": 38,
        "first_name": "Bukayo",
        "last_name": "Saka",
        "display_name": "Bukayo Saka",
        "short_name": "B Saka",
        "date_of_birth": "2001-09-05",
        "age": 24,
        "height": "5' 10\"",
        "weight": "159 lbs",
        "citizenship": "England"
      },
      "season": 2025,
      "jersey_number": "7",
      "position": "Forward",
      "position_abbreviation": "F",
      "is_active": true
    },
    ...
  ]
}

This endpoint retrieves the roster for a specific team.

HTTP Request

GET https://api.balldontlie.io/epl/v2/rosters

Query Parameters

Parameter	Required	Description
team_id	true	The team ID to get roster for
season	false	Returns roster for this season

Players

Get All Players

curl "https://api.balldontlie.io/epl/v2/players?per_page=5" \
  -H "Authorization: YOUR_API_KEY"

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

import requests

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

{
  "data": [
    {
      "id": 101,
      "first_name": "Aaron",
      "last_name": "Hickey",
      "display_name": "Aaron Hickey",
      "short_name": "A Hickey",
      "date_of_birth": "2002-06-10",
      "age": 23,
      "height": "5' 10\"",
      "weight": "159 lbs",
      "citizenship": "Scotland",
      "team_ids": [4]
    },
    {
      "id": 2428,
      "first_name": "Aaron",
      "last_name": "Ramsdale",
      "display_name": "Aaron Ramsdale",
      "short_name": "A Ramsdale",
      "date_of_birth": "1998-05-14",
      "age": 27,
      "height": "6' 3\"",
      "weight": "192 lbs",
      "citizenship": "England",
      "team_ids": [2, 1, 15]
    },
    ...
  ],
  "meta": {
    "next_cursor": 2428,
    "per_page": 5
  }
}

This endpoint retrieves all players.

HTTP Request

GET https://api.balldontlie.io/epl/v2/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 by player name

Standings

Get Standings

curl "https://api.balldontlie.io/epl/v2/standings" \
  -H "Authorization: YOUR_API_KEY"

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

import requests

response = requests.get(
    "https://api.balldontlie.io/epl/v2/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": "English Premier League 2025-2026",
      "note": "Champions League",
      "games_played": 21,
      "wins": 15,
      "losses": 2,
      "draws": 4,
      "points": 49,
      "goals_for": 40,
      "goals_against": 14,
      "goal_differential": 26,
      "points_per_game": 0
    },
    {
      "team": {
        "id": 13,
        "name": "Manchester City",
        "short_name": "Man City",
        "abbreviation": "MNC",
        "location": "Manchester City"
      },
      "season": 2025,
      "rank": 2,
      "rank_change": 0,
      "group_name": "English Premier League 2025-2026",
      "note": "Champions League",
      "games_played": 22,
      "wins": 13,
      "losses": 5,
      "draws": 4,
      "points": 43,
      "goals_for": 45,
      "goals_against": 21,
      "goal_differential": 24,
      "points_per_game": 0
    },
    ...
  ]
}

This endpoint retrieves team standings.

HTTP Request

GET https://api.balldontlie.io/epl/v2/standings

Query Parameters

Parameter	Required	Description
season	false	Returns team standings for this season

Matches

Get All Matches

curl "https://api.balldontlie.io/epl/v2/matches?dates[]=2024-12-22" \
  -H "Authorization: YOUR_API_KEY"

const response = await fetch(
  "https://api.balldontlie.io/epl/v2/matches?dates[]=2024-12-22",
  {
    headers: {
      "Authorization": "YOUR_API_KEY"
    }
  }
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.balldontlie.io/epl/v2/matches",
    params={"dates[]": "2024-12-22"},
    headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()

{
  "data": [
    {
      "id": 371,
      "season": 2024,
      "home_team_id": 1,
      "away_team_id": 131,
      "date": "2025-05-25T15:00:00.000Z",
      "name": "Leicester City at AFC Bournemouth",
      "short_name": "LEI @ BOU",
      "status": "STATUS_FULL_TIME",
      "status_detail": "FT",
      "home_score": 2,
      "away_score": 0,
      "venue_name": "Vitality Stadium",
      "venue_city": "Bournemouth",
      "attendance": 11238
    },
    {
      "id": 372,
      "season": 2024,
      "home_team_id": 10,
      "away_team_id": 13,
      "date": "2025-05-25T15:00:00.000Z",
      "name": "Manchester City at Fulham",
      "short_name": "MNC @ FUL",
      "status": "STATUS_FULL_TIME",
      "status_detail": "FT",
      "home_score": 0,
      "away_score": 2,
      "venue_name": "Craven Cottage",
      "venue_city": "London",
      "attendance": 27671
    },
    ...
  ],
  "meta": {
    "next_cursor": 373,
    "per_page": 25
  }
}

This endpoint retrieves all matches.

HTTP Request

GET https://api.balldontlie.io/epl/v2/matches

Query Parameters

Parameter	Required	Description
cursor	false	The cursor for pagination
per_page	false	Number of results per page (max 100)
season	false	Returns matches for this season
team_ids	false	Filter matches by team IDs (array)
dates	false	Filter by dates (array, YYYY-MM-DD)

Match Events

Get Match Events

curl "https://api.balldontlie.io/epl/v2/match_events?match_ids[]=371" \
  -H "Authorization: YOUR_API_KEY"

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

import requests

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

{
  "data": [
    {
      "id": 24832,
      "match_id": 371,
      "team_id": 1,
      "event_type": "goal",
      "event_time": 74,
      "period": 2,
      "player": {
        "id": 20,
        "first_name": "Antoine",
        "last_name": "Semenyo",
        "display_name": "Antoine Semenyo",
        "short_name": "A Semenyo",
        "date_of_birth": "2000-01-07",
        "age": 26,
        "height": "6' 1\"",
        "weight": "172 lbs",
        "citizenship": "Ghana"
      },
      "secondary_player": null,
      "goal_type": "regular",
      "is_own_goal": false
    },
    {
      "id": 24827,
      "match_id": 371,
      "team_id": 131,
      "event_type": "yellow_card",
      "event_time": 38,
      "period": 1,
      "player": {
        "id": 2779,
        "first_name": "Conor",
        "last_name": "Coady",
        "display_name": "Conor Coady",
        "short_name": "C Coady",
        "date_of_birth": "1993-02-25",
        "age": 32,
        "height": "6' 1\"",
        "weight": "174 lbs",
        "citizenship": "England"
      },
      "secondary_player": null,
      "goal_type": null,
      "is_own_goal": false
    },
    {
      "id": 24828,
      "match_id": 371,
      "team_id": 1,
      "event_type": "substitution",
      "event_time": 63,
      "period": 2,
      "player": {
        "id": 17,
        "first_name": "Daniel",
        "last_name": "Jebbison",
        "display_name": "Daniel Jebbison",
        "short_name": "D Jebbison",
        "date_of_birth": "2003-08-13",
        "age": 22,
        "height": "6' 3\"",
        "weight": "150 lbs",
        "citizenship": "Canada"
      },
      "secondary_player": null,
      "goal_type": null,
      "is_own_goal": false
    },
    ...
  ]
}

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

HTTP Request

GET https://api.balldontlie.io/epl/v2/match_events

Query Parameters

Parameter	Required	Description
match_ids	false	Filter by match IDs (array)
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/epl/v2/match_lineups?match_ids[]=371" \
  -H "Authorization: YOUR_API_KEY"

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

import requests

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

{
  "data": [
    {
      "match_id": 371,
      "team_id": 1,
      "player": {
        "id": 11,
        "first_name": "Kepa",
        "last_name": "Arrizabalaga",
        "display_name": "Kepa Arrizabalaga",
        "short_name": "K Arrizabalaga",
        "date_of_birth": "1994-10-03",
        "age": 31,
        "height": "6' 2\"",
        "weight": "183 lbs",
        "citizenship": "Spain"
      },
      "is_starter": true,
      "position": "Goalkeeper",
      "position_abbreviation": "G",
      "formation_position": "1",
      "jersey_number": null
    },
    {
      "match_id": 371,
      "team_id": 1,
      "player": {
        "id": 20,
        "first_name": "Antoine",
        "last_name": "Semenyo",
        "display_name": "Antoine Semenyo",
        "short_name": "A Semenyo",
        "date_of_birth": "2000-01-07",
        "age": 26,
        "height": "6' 1\"",
        "weight": "172 lbs",
        "citizenship": "Ghana"
      },
      "is_starter": true,
      "position": "Attacking Midfielder Left",
      "position_abbreviation": "AM-L",
      "formation_position": "11",
      "jersey_number": null
    },
    ...
  ]
}

This endpoint retrieves lineups for matches.

HTTP Request

GET https://api.balldontlie.io/epl/v2/match_lineups

Query Parameters

Parameter	Required	Description
match_ids	false	Filter by match IDs (array)
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/epl/v2/player_match_stats?match_ids[]=371" \
  -H "Authorization: YOUR_API_KEY"

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

import requests

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

{
  "data": [
    {
      "match_id": 371,
      "player_id": 20,
      "team_id": 1,
      "appearances": 1,
      "goals": 2,
      "assists": 0,
      "shots_total": 4,
      "shots_on_target": 2,
      "fouls_committed": 3,
      "fouls_suffered": null,
      "offsides": 1,
      "saves": null,
      "yellow_cards": 0,
      "red_cards": 0,
      "own_goals": 0
    },
    {
      "match_id": 371,
      "player_id": 2779,
      "team_id": 131,
      "appearances": 1,
      "goals": 0,
      "assists": 0,
      "shots_total": null,
      "shots_on_target": null,
      "fouls_committed": 1,
      "fouls_suffered": null,
      "offsides": null,
      "saves": null,
      "yellow_cards": 1,
      "red_cards": 0,
      "own_goals": 0
    },
    {
      "match_id": 371,
      "player_id": 3386,
      "team_id": 131,
      "appearances": 1,
      "goals": 0,
      "assists": 0,
      "shots_total": null,
      "shots_on_target": null,
      "fouls_committed": null,
      "fouls_suffered": null,
      "offsides": null,
      "saves": 5,
      "yellow_cards": 0,
      "red_cards": 0,
      "own_goals": 0
    },
    ...
  ]
}

This endpoint retrieves player statistics for matches.

HTTP Request

GET https://api.balldontlie.io/epl/v2/player_match_stats

Query Parameters

Parameter	Required	Description
match_ids	false	Filter by match IDs (array)
player_ids	false	Filter by player IDs (array)
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/epl/v2/team_match_stats?match_ids[]=371" \
  -H "Authorization: YOUR_API_KEY"

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

import requests

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

{
  "data": [
    {
      "match_id": 371,
      "team_id": 1,
      "possession_pct": 62.7,
      "shots": 20,
      "shots_on_target": 7,
      "fouls": 19,
      "yellow_cards": 0,
      "red_cards": 0,
      "corners": null,
      "passes": 497,
      "pass_accuracy_pct": null
    },
    {
      "match_id": 371,
      "team_id": 131,
      "possession_pct": 37.3,
      "shots": 3,
      "shots_on_target": 0,
      "fouls": 16,
      "yellow_cards": 2,
      "red_cards": 0,
      "corners": null,
      "passes": 301,
      "pass_accuracy_pct": null
    }
  ],
  "meta": {
    "per_page": 25
  }
}

This endpoint retrieves team statistics for matches.

HTTP Request

GET https://api.balldontlie.io/epl/v2/team_match_stats

Query Parameters

Parameter	Required	Description
match_ids	false	Filter by match IDs (array)
team_ids	false	Filter by team IDs (array)
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/epl/v2/odds?per_page=3" \
  -H "Authorization: YOUR_API_KEY"

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

import requests

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

{
  "data": [
    {
      "id": 89549453,
      "match_id": 1773,
      "vendor": "caesars",
      "moneyline_home_odds": -110,
      "moneyline_away_odds": 260,
      "moneyline_draw_odds": 280,
      "updated_at": "2026-01-17T15:01:00.387Z"
    },
    {
      "id": 89548970,
      "match_id": 1773,
      "vendor": "draftkings",
      "moneyline_home_odds": -115,
      "moneyline_away_odds": 270,
      "moneyline_draw_odds": 275,
      "updated_at": "2026-01-17T15:01:00.490Z"
    },
    {
      "id": 89548959,
      "match_id": 1773,
      "vendor": "fanduel",
      "moneyline_home_odds": -120,
      "moneyline_away_odds": 290,
      "moneyline_draw_odds": 290,
      "updated_at": "2026-01-17T15:01:00.416Z"
    }
  ],
  "meta": {
    "next_cursor": 89548959,
    "per_page": 3
  }
}

This endpoint retrieves betting odds for Premier League matches. Premier League odds include moneyline odds for home, away, and draw outcomes only (no spreads or totals).

Available Vendors:

draftkings
fanduel
caesars
polymarket
kalshi

HTTP Request

GET https://api.balldontlie.io/epl/v2/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)
dates	false	Filter by dates (array, YYYY-MM-DD)

Player Props

The Player Props API provides real-time player prop betting odds for Premier 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/epl/v2/odds/player_props?match_id=2410" \
  -H "Authorization: YOUR_API_KEY"

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

import requests

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

{
  "data": [
    {
      "id": 1125005626,
      "match_id": 2410,
      "player_id": 1240,
      "vendor": "fanduel",
      "prop_type": "anytime_goal",
      "line_value": "1",
      "market": {
        "type": "milestone",
        "odds": 5000
      },
      "updated_at": "2025-12-22T21:54:02.301Z"
    },
    {
      "id": 1125005616,
      "match_id": 2410,
      "player_id": 1243,
      "vendor": "fanduel",
      "prop_type": "shots",
      "line_value": "5",
      "market": {
        "type": "milestone",
        "odds": 2700
      },
      "updated_at": "2025-12-22T21:54:02.301Z"
    },
    {
      "id": 1125005617,
      "match_id": 2410,
      "player_id": 1243,
      "vendor": "fanduel",
      "prop_type": "shots_on_target",
      "line_value": "4",
      "market": {
        "type": "milestone",
        "odds": 6000
      },
      "updated_at": "2025-12-22T21:54:02.301Z"
    },
    ...
  ]
}

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

Available Vendors:

draftkings
fanduel
caesars

HTTP Request

GET https://api.balldontlie.io/epl/v2/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 types.

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.