MLS API
Welcome to the BALLDONTLIE MLS API. This API contains data from Major League Soccer. 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 MLS 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 Inter Miami's current roster"
- "Read the BALLDONTLIE OpenAPI spec and create a Python script that fetches this week's MLS matches"
- "Help me understand the available MLS 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 MLS 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
To authorize, use this code:
curl "https://api.balldontlie.io/mls/v1/teams" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch("https://api.balldontlie.io/mls/v1/teams", {
headers: {
"Authorization": "YOUR_API_KEY"
}
});
const data = await response.json();
import requests
response = requests.get(
"https://api.balldontlie.io/mls/v1/teams",
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
Make sure to replace
YOUR_API_KEYwith your API key.
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
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/mls/v1/teams" \
-H "Authorization: YOUR_API_KEY"
# With optional season parameter
curl "https://api.balldontlie.io/mls/v1/teams?season=2024" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch("https://api.balldontlie.io/mls/v1/teams", {
headers: {
"Authorization": "YOUR_API_KEY"
}
});
const data = await response.json();
// With optional season parameter
const response2024 = await fetch(
"https://api.balldontlie.io/mls/v1/teams?season=2024",
{
headers: { "Authorization": "YOUR_API_KEY" }
}
);
const data2024 = await response2024.json();
import requests
response = requests.get(
"https://api.balldontlie.io/mls/v1/teams",
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
# With optional season parameter
response_2024 = requests.get(
"https://api.balldontlie.io/mls/v1/teams",
params={"season": 2024},
headers={"Authorization": "YOUR_API_KEY"}
)
data_2024 = response_2024.json()
The above command returns JSON structured like this:
{
"data": [
{
"id": 497055,
"name": "Austin FC",
"short_name": "Austin",
"abbreviation": "ATX",
"location": "Austin FC"
},
{
"id": 497054,
"name": "Atlanta United FC",
"short_name": "Atlanta",
"abbreviation": "ATL",
"location": "Atlanta United FC"
},
{
"id": 497065,
"name": "Inter Miami CF",
"short_name": "Miami",
"abbreviation": "MIA",
"location": "Inter Miami CF"
},
{
"id": 497066,
"name": "LA Galaxy",
"short_name": "LA Galaxy",
"abbreviation": "LA",
"location": "LA Galaxy"
}
]
}
This endpoint retrieves all teams.
HTTP Request
GET https://api.balldontlie.io/mls/v1/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/mls/v1/rosters?team_id=497065" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch(
"https://api.balldontlie.io/mls/v1/rosters?team_id=497065",
{
headers: {
"Authorization": "YOUR_API_KEY"
}
}
);
const data = await response.json();
import requests
response = requests.get(
"https://api.balldontlie.io/mls/v1/rosters",
params={"team_id": 497065},
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
The above command returns JSON structured like this:
{
"data": [
{
"team_id": 497065,
"player": {
"id": 7455,
"first_name": "Lionel",
"last_name": "Messi",
"display_name": "Lionel Messi",
"short_name": "L Messi",
"date_of_birth": "1987-06-24",
"age": 38,
"height": "5' 7\"",
"weight": "148 lbs",
"citizenship": "Argentina"
},
"season": 2024,
"jersey_number": "10",
"position": "Forward",
"position_abbreviation": "F",
"is_active": true
},
{
"team_id": 497065,
"player": {
"id": 7423,
"first_name": "Luis",
"last_name": "Suarez",
"display_name": "Luis Suarez",
"short_name": "L Suarez",
"date_of_birth": "1987-01-24",
"age": 38,
"height": "6' 0\"",
"weight": "159 lbs",
"citizenship": "Uruguay"
},
"season": 2024,
"jersey_number": "9",
"position": "Forward",
"position_abbreviation": "F",
"is_active": true
},
{
"team_id": 497065,
"player": {
"id": 7451,
"first_name": "Sergio",
"last_name": "Busquets",
"display_name": "Sergio Busquets",
"short_name": "S Busquets",
"date_of_birth": "1988-07-16",
"age": 37,
"height": "6' 2\"",
"weight": "161 lbs",
"citizenship": "Spain"
},
"season": 2024,
"jersey_number": "5",
"position": "Midfielder",
"position_abbreviation": "M",
"is_active": true
}
]
}
This endpoint retrieves the roster for a specific team.
HTTP Request
GET https://api.balldontlie.io/mls/v1/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/mls/v1/players?per_page=5" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch(
"https://api.balldontlie.io/mls/v1/players?per_page=5",
{
headers: {
"Authorization": "YOUR_API_KEY"
}
}
);
const data = await response.json();
import requests
response = requests.get(
"https://api.balldontlie.io/mls/v1/players",
params={"per_page": 5},
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
The above command returns JSON structured like this:
{
"data": [
{
"id": 199304,
"first_name": "Aaron",
"last_name": "Bibout",
"display_name": "Aaron Bibout",
"short_name": "A Bibout",
"date_of_birth": "2004-09-03",
"age": 21,
"height": "6' 4\"",
"weight": null,
"citizenship": "Cameroon",
"team_ids": [497066]
},
{
"id": 186405,
"first_name": "Aaron",
"last_name": "Chandler",
"display_name": "Aaron Chandler",
"short_name": "A Chandler",
"date_of_birth": "1983-10-03",
"age": 42,
"height": "6' 1\"",
"weight": "160 lbs",
"citizenship": "USA",
"team_ids": [497060]
}
],
"meta": {
"next_cursor": 186405,
"per_page": 5
}
}
This endpoint retrieves all players.
HTTP Request
GET https://api.balldontlie.io/mls/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 by player name |
Standings
Get Standings
curl "https://api.balldontlie.io/mls/v1/standings" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch(
"https://api.balldontlie.io/mls/v1/standings",
{
headers: {
"Authorization": "YOUR_API_KEY"
}
}
);
const data = await response.json();
import requests
response = requests.get(
"https://api.balldontlie.io/mls/v1/standings",
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
The above command returns JSON structured like this:
{
"data": [
{
"team": {
"id": 497065,
"name": "Inter Miami CF",
"short_name": "Miami",
"abbreviation": "MIA",
"location": "Inter Miami CF"
},
"season": 2024,
"rank": 1,
"rank_change": 0,
"group_name": "Eastern Conference",
"note": "Qualifies for MLS Cup Playoffs - Round One Best-of-3 series",
"games_played": 34,
"wins": 22,
"losses": 4,
"draws": 8,
"points": 74,
"goals_for": 79,
"goals_against": 49,
"goal_differential": 30,
"points_per_game": 2.18
},
{
"team": {
"id": 497060,
"name": "Columbus Crew",
"short_name": "Columbus",
"abbreviation": "CLB",
"location": "Columbus Crew"
},
"season": 2024,
"rank": 2,
"rank_change": 0,
"group_name": "Eastern Conference",
"note": "Qualifies for MLS Cup Playoffs - Round One Best-of-3 series",
"games_played": 34,
"wins": 19,
"losses": 6,
"draws": 9,
"points": 66,
"goals_for": 72,
"goals_against": 40,
"goal_differential": 32,
"points_per_game": 1.94
},
{
"team": {
"id": 497067,
"name": "LAFC",
"short_name": "LAFC",
"abbreviation": "LAFC",
"location": "LAFC"
},
"season": 2024,
"rank": 1,
"rank_change": 0,
"group_name": "Western Conference",
"note": "Qualifies for MLS Cup Playoffs - Round One Best-of-3 series",
"games_played": 34,
"wins": 19,
"losses": 8,
"draws": 7,
"points": 64,
"goals_for": 63,
"goals_against": 43,
"goal_differential": 20,
"points_per_game": 1.88
}
]
}
This endpoint retrieves team standings. MLS standings are organized by conference (Eastern Conference and Western Conference).
HTTP Request
GET https://api.balldontlie.io/mls/v1/standings
Query Parameters
| Parameter | Required | Description |
|---|---|---|
| season | false | Returns team standings for this season |
Matches
Get All Matches
curl "https://api.balldontlie.io/mls/v1/matches?season=2024&per_page=2" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch(
"https://api.balldontlie.io/mls/v1/matches?season=2024&per_page=2",
{
headers: {
"Authorization": "YOUR_API_KEY"
}
}
);
const data = await response.json();
import requests
response = requests.get(
"https://api.balldontlie.io/mls/v1/matches",
params={"season": 2024, "per_page": 2},
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
The above command returns JSON structured like this:
{
"data": [
{
"id": 245378,
"season": 2024,
"home_team_id": 497066,
"away_team_id": 497072,
"date": "2024-12-07T21:00:00.000Z",
"name": "New York Red Bulls at LA Galaxy",
"short_name": "NY @ LA",
"status": "STATUS_FULL_TIME",
"status_detail": "FT",
"home_score": 2,
"away_score": 1,
"venue_name": "Dignity Health Sports Park",
"venue_city": "Carson, California",
"attendance": 26812
}
],
"meta": {
"next_cursor": 245378,
"per_page": 1
}
}
This endpoint retrieves all matches.
HTTP Request
GET https://api.balldontlie.io/mls/v1/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/mls/v1/match_events?match_id=237289" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch(
"https://api.balldontlie.io/mls/v1/match_events?match_id=237289",
{
headers: {
"Authorization": "YOUR_API_KEY"
}
}
);
const data = await response.json();
import requests
response = requests.get(
"https://api.balldontlie.io/mls/v1/match_events",
params={"match_id": 237289},
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
The above command returns JSON structured like this:
{
"data": [
{
"id": 384543,
"match_id": 237289,
"team_id": 497070,
"event_type": "goal",
"event_time": 17,
"period": 1,
"player": {
"id": 185196,
"first_name": "Dario",
"last_name": "Fabbro",
"display_name": "Dario Fabbro",
"short_name": "D Fabbro",
"date_of_birth": "1976-11-03",
"age": 49,
"height": "6' 2\"",
"weight": "178 lbs",
"citizenship": "Argentina"
},
"secondary_player": null,
"goal_type": "regular",
"is_own_goal": false
},
{
"id": 384546,
"match_id": 237289,
"team_id": 497072,
"event_type": "substitution",
"event_time": 45,
"period": 1,
"player": {
"id": 185332,
"first_name": "Eddie",
"last_name": "Gaven",
"display_name": "Eddie Gaven",
"short_name": "E Gaven",
"date_of_birth": "1986-10-25",
"age": 39,
"height": "5' 11\"",
"weight": "163 lbs",
"citizenship": "USA"
},
"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/mls/v1/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/mls/v1/match_lineups?match_id=237289" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch(
"https://api.balldontlie.io/mls/v1/match_lineups?match_id=237289",
{
headers: {
"Authorization": "YOUR_API_KEY"
}
}
);
const data = await response.json();
import requests
response = requests.get(
"https://api.balldontlie.io/mls/v1/match_lineups",
params={"match_id": 237289},
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
The above command returns JSON structured like this:
{
"data": [
{
"match_id": 237289,
"team_id": 497070,
"player": {
"id": 185198,
"first_name": null,
"last_name": null,
"display_name": "Adin Brown",
"short_name": null,
"date_of_birth": null,
"age": null,
"height": null,
"weight": null,
"citizenship": null
},
"is_starter": true,
"position": "Goalkeeper",
"position_abbreviation": "G",
"formation_position": null,
"jersey_number": null
},
{
"match_id": 237289,
"team_id": 497070,
"player": {
"id": 185224,
"first_name": "Shalrie",
"last_name": "Joseph",
"display_name": "Shalrie Joseph",
"short_name": "S Joseph",
"date_of_birth": "1978-05-24",
"age": 47,
"height": "6' 3\"",
"weight": "194 lbs",
"citizenship": "Grenada"
},
"is_starter": true,
"position": "Midfielder",
"position_abbreviation": "M",
"formation_position": null,
"jersey_number": null
}
]
}
This endpoint retrieves lineups for matches.
HTTP Request
GET https://api.balldontlie.io/mls/v1/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/mls/v1/player_match_stats?match_id=238150" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch(
"https://api.balldontlie.io/mls/v1/player_match_stats?match_id=238150",
{
headers: {
"Authorization": "YOUR_API_KEY"
}
}
);
const data = await response.json();
import requests
response = requests.get(
"https://api.balldontlie.io/mls/v1/player_match_stats",
params={"match_id": 238150},
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
The above command returns JSON structured like this:
{
"data": [
{
"match_id": 238150,
"player_id": 186772,
"team_id": 497060,
"appearances": 1,
"goals": 1,
"assists": 0,
"shots_total": 2,
"shots_on_target": 1,
"fouls_committed": 3,
"fouls_suffered": 1,
"offsides": null,
"saves": null,
"yellow_cards": 0,
"red_cards": 0,
"own_goals": 0
},
{
"match_id": 238150,
"player_id": 185169,
"team_id": 497060,
"appearances": 1,
"goals": 0,
"assists": 0,
"shots_total": 1,
"shots_on_target": 1,
"fouls_committed": null,
"fouls_suffered": 3,
"offsides": null,
"saves": null,
"yellow_cards": 0,
"red_cards": 0,
"own_goals": 0
}
]
}
This endpoint retrieves player statistics for matches.
HTTP Request
GET https://api.balldontlie.io/mls/v1/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/mls/v1/team_match_stats?match_id=238150" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch(
"https://api.balldontlie.io/mls/v1/team_match_stats?match_id=238150",
{
headers: {
"Authorization": "YOUR_API_KEY"
}
}
);
const data = await response.json();
import requests
response = requests.get(
"https://api.balldontlie.io/mls/v1/team_match_stats",
params={"match_id": 238150},
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
The above command returns JSON structured like this:
{
"data": [
{
"match_id": 238150,
"team_id": 497060,
"possession_pct": 50,
"shots": 9,
"shots_on_target": 6,
"fouls": 13,
"yellow_cards": 1,
"red_cards": 0,
"corners": null,
"passes": 2,
"pass_accuracy_pct": null
},
{
"match_id": 238150,
"team_id": 497082,
"possession_pct": 50,
"shots": 11,
"shots_on_target": 4,
"fouls": 8,
"yellow_cards": 1,
"red_cards": 0,
"corners": null,
"passes": 2,
"pass_accuracy_pct": null
}
],
"meta": {
"per_page": 25
}
}
This endpoint retrieves team statistics for matches.
HTTP Request
GET https://api.balldontlie.io/mls/v1/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/mls/v1/odds?per_page=3" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch(
"https://api.balldontlie.io/mls/v1/odds?per_page=3",
{
headers: {
"Authorization": "YOUR_API_KEY"
}
}
);
const data = await response.json();
import requests
response = requests.get(
"https://api.balldontlie.io/mls/v1/odds",
params={"per_page": 3},
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
The above command returns JSON structured like this:
{
"data": [
{
"id": 40975309,
"match_id": 2410,
"vendor": "caesars",
"moneyline_home_odds": 10000,
"moneyline_away_odds": -7500,
"moneyline_draw_odds": 2500,
"updated_at": "2025-12-22T21:54:00.185Z"
},
{
"id": 40967282,
"match_id": 2410,
"vendor": "draftkings",
"moneyline_home_odds": 12000,
"moneyline_away_odds": -2000,
"moneyline_draw_odds": 800,
"updated_at": "2025-12-22T21:52:00.314Z"
},
{
"id": 40801973,
"match_id": 2410,
"vendor": "fanduel",
"moneyline_home_odds": 10000,
"moneyline_away_odds": -20000,
"moneyline_draw_odds": 6500,
"updated_at": "2025-12-22T21:54:00.224Z"
}
],
"meta": {
"next_cursor": 40801973,
"per_page": 3
}
}
This endpoint retrieves betting odds for MLS matches. MLS 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/mls/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) |
| dates | false | Filter by dates (array, YYYY-MM-DD) |
Player Props
The Player Props API provides real-time player prop betting odds for MLS 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/mls/v1/odds/player_props?match_id=2410" \
-H "Authorization: YOUR_API_KEY"
const response = await fetch(
"https://api.balldontlie.io/mls/v1/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/mls/v1/odds/player_props",
params={"match_id": 2410},
headers={"Authorization": "YOUR_API_KEY"}
)
data = response.json()
The above command returns JSON structured like this:
{
"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 MLS match. The match_id parameter is required.
Available Vendors:
- draftkings
- fanduel
- caesars
HTTP Request
GET https://api.balldontlie.io/mls/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 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.