MLB — ESPN core API (v2) — Game

espn_mlb_game_competition

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
attendance	integer	Reported attendance (NA on the redesigned page).
boxscore_available	logical
bracket_available	logical
commentary_available	logical
competitors	character
conference_competition	logical	Conference competition.
conversation_available	logical
date	character	Date in YYYY-MM-DD format.
division_competition	logical
gamecast_available	logical
guid	character	Stable cross-league team GUID.
highlights_available	logical
id	character	Id.
lineup_available	logical
links	character
live_available	logical
necessary	logical
neutral_site	logical	Neutral-site venue (when not hosted by either team).
notes	character	Notes.
on_watch_espn	logical
pickcenter_available	logical
play_by_play_available	logical	TRUE if play-by-play is available.
possession_arrow_available	logical
preview_available	logical
recap_available	logical
recent	logical
series	character
shot_chart_available	logical
summary_available	logical
tickets_available	logical
time_valid	logical
timeouts_available	logical
uid	character	ESPN UID string.
wallclock_available	logical
boxscore_source_description	character
boxscore_source_id	character
boxscore_source_state	character
broadcasts_$ref	character
details_$ref	character
format_overtime_clock	double
format_overtime_display_name	character
format_overtime_slug	character
format_regulation_clock	double
format_regulation_display_name	character
format_regulation_periods	integer
format_regulation_slug	character
game_source_description	character
game_source_id	character
game_source_state	character
linescore_source_description	character
linescore_source_id	character
linescore_source_state	character
odds_$ref	character
officials_$ref	character
play_by_play_source_description	character
play_by_play_source_id	character
play_by_play_source_state	character
power_indexes_$ref	character
predictor_$ref	character
probabilities_$ref	character
relevancy_$ref	character
situation_$ref	character
stats_source_description	character
stats_source_id	character
stats_source_state	character
status_$ref	character
type_abbreviation	character	Play type abbreviation.
type_id	character	Type id.
type_slug	character
type_text	character	Type text.
type_type	character	Play type category.
venue_$ref	character
venue_address_city	character
venue_address_state	character
venue_full_name	character
venue_grass	logical
venue_guid	character
venue_id	character	MLBAM venue ID.
venue_images	character
venue_indoor	logical

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_competition(event_id='401584793')

Last validated n/a.

espn_mlb_game_teams

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/competitors

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/competitors

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
home_away	character	Venue label for the team ('home' or 'away').
id	character	Id.
order	integer	Order.
type	character	Record type / category.
uid	character	ESPN UID string.
winner	logical	Winner.
leaders_$ref	character
linescores_$ref	character
record_$ref	character
roster_$ref	character
score_$ref	character
statistics_$ref	character
team_$ref	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_teams(event_id='401584793')

Last validated n/a.

espn_mlb_game_team

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/competitors/{team_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/competitors/4

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
home_away	character	Venue label for the team ('home' or 'away').
id	character	Id.
order	integer	Order.
type	character	Record type / category.
uid	character	ESPN UID string.
winner	logical	Winner.
leaders_$ref	character
linescores_$ref	character
record_$ref	character
roster_$ref	character
score_$ref	character
statistics_$ref	character
team_$ref	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_team(event_id='401584793', team_id='4')

Last validated n/a.

espn_mlb_game_team_roster

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/competitors/{team_id}/roster

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/competitors/4/roster

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
active	logical	Whether the player is currently active.
starter	logical	TRUE if the player started the game.
did_not_play	logical	Did not play.
ejected	logical	Ejected.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_team_roster(event_id='401584793', team_id='4')

Last validated n/a.

espn_mlb_game_team_linescores

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/competitors/{team_id}/linescores

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/competitors/4/linescores

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_event_competitor_linescores; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: the page holds zero items (count 0) in nba with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_team_linescores(event_id='401584793', team_id='4')

Last validated n/a.

espn_mlb_game_team_statistics

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/competitors/{team_id}/statistics

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/competitors/4/statistics

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_event_competitor_statistics; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: parser: parse_event_competitor_statistics raises AttributeError: 'str' object has no attribute 'get' on the live payload (nba, 2026-10-07), so no columns can be derived.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_team_statistics(event_id='401584793', team_id='4')

Last validated n/a.

espn_mlb_game_team_record

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/competitors/{team_id}/record

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/competitors/4/record

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_single_entity; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_team_record(event_id='401584793', team_id='4')

Last validated n/a.

espn_mlb_game_team_leaders

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/competitors/{team_id}/leaders

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/competitors/4/leaders

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
team_id	team_id		Y		team_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: parser: parse_items returns no columns on the live payload (nba, 2026-10-07); its rows sit under keys it does not read (top level: $ref, abbreviation, categories, id, name, type).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_team_leaders(event_id='401584793', team_id='4')

Last validated n/a.

espn_mlb_game_odds

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/odds

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/odds

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
details	character	Details.
moneyline_winner	logical
over_odds	double
over_under	double	Over under.
spread	double	Spread.
spread_winner	logical
under_odds	double
away_team_odds_close_money_line_alternate_display_value	character
away_team_odds_close_money_line_american	character
away_team_odds_close_money_line_decimal	double
away_team_odds_close_money_line_display_value	character
away_team_odds_close_money_line_fraction	character
away_team_odds_close_money_line_value	double
away_team_odds_close_point_spread_alternate_display_value	character
away_team_odds_close_point_spread_american	character
away_team_odds_close_spread_alternate_display_value	character
away_team_odds_close_spread_american	character
away_team_odds_close_spread_decimal	double
away_team_odds_close_spread_display_value	character
away_team_odds_close_spread_fraction	character
away_team_odds_close_spread_value	double
away_team_odds_current_money_line_alternate_display_value	character
away_team_odds_current_money_line_american	character
away_team_odds_current_money_line_decimal	double
away_team_odds_current_money_line_display_value	character
away_team_odds_current_money_line_fraction	character
away_team_odds_current_money_line_value	double
away_team_odds_current_point_spread_alternate_display_value	character
away_team_odds_current_point_spread_american	character
away_team_odds_current_spread_alternate_display_value	character
away_team_odds_current_spread_american	character
away_team_odds_current_spread_decimal	double
away_team_odds_current_spread_display_value	character
away_team_odds_current_spread_fraction	character
away_team_odds_current_spread_value	double
away_team_odds_favorite	logical	Away team's team odds favorite.
away_team_odds_money_line	integer	Away team's team odds money line.
away_team_odds_open_favorite	logical
away_team_odds_open_money_line_alternate_display_value	character
away_team_odds_open_money_line_american	character
away_team_odds_open_money_line_decimal	double
away_team_odds_open_money_line_display_value	character
away_team_odds_open_money_line_fraction	character
away_team_odds_open_money_line_value	double
away_team_odds_open_point_spread_alternate_display_value	character
away_team_odds_open_point_spread_american	character
away_team_odds_open_spread_alternate_display_value	character
away_team_odds_open_spread_american	character
away_team_odds_open_spread_decimal	double
away_team_odds_open_spread_display_value	character
away_team_odds_open_spread_fraction	character
away_team_odds_open_spread_value	double
away_team_odds_spread_odds	double	Away team's team odds spread odds.
away_team_odds_team_$ref	character
away_team_odds_underdog	logical	Away team's team odds underdog.
close_over_alternate_display_value	character
close_over_american	character
close_over_decimal	double
close_over_display_value	character
close_over_fraction	character
close_over_value	double
close_total_alternate_display_value	character
close_total_american	character
close_total_decimal	double
close_total_display_value	character
close_total_fraction	character
close_total_value	double
close_under_alternate_display_value	character
close_under_american	character
close_under_decimal	double
close_under_display_value	character
close_under_fraction	character
close_under_value	double
current_over_alternate_display_value	character
current_over_american	character
current_over_decimal	double
current_over_display_value	character
current_over_fraction	character
current_over_value	double
current_total_alternate_display_value	character
current_total_american	character
current_total_decimal	double
current_total_display_value	character
current_total_fraction	character
current_total_value	double
current_under_alternate_display_value	character
current_under_american	character
current_under_decimal	double
current_under_display_value	character
current_under_fraction	character
current_under_value	double
home_team_odds_close_money_line_alternate_display_value	character
home_team_odds_close_money_line_american	character
home_team_odds_close_money_line_decimal	double
home_team_odds_close_money_line_display_value	character
home_team_odds_close_money_line_fraction	character
home_team_odds_close_money_line_value	double
home_team_odds_close_point_spread_alternate_display_value	character
home_team_odds_close_point_spread_american	character
home_team_odds_close_point_spread_decimal	double
home_team_odds_close_point_spread_display_value	character
home_team_odds_close_point_spread_fraction	character
home_team_odds_close_point_spread_value	double
home_team_odds_close_spread_alternate_display_value	character
home_team_odds_close_spread_american	character
home_team_odds_close_spread_decimal	double
home_team_odds_close_spread_display_value	character
home_team_odds_close_spread_fraction	character
home_team_odds_close_spread_value	double
home_team_odds_current_money_line_alternate_display_value	character
home_team_odds_current_money_line_american	character
home_team_odds_current_money_line_decimal	double
home_team_odds_current_money_line_display_value	character
home_team_odds_current_money_line_fraction	character
home_team_odds_current_money_line_value	double
home_team_odds_current_point_spread_alternate_display_value	character
home_team_odds_current_point_spread_american	character
home_team_odds_current_point_spread_decimal	double
home_team_odds_current_point_spread_display_value	character
home_team_odds_current_point_spread_fraction	character
home_team_odds_current_point_spread_value	double
home_team_odds_current_spread_alternate_display_value	character
home_team_odds_current_spread_american	character
home_team_odds_current_spread_decimal	double
home_team_odds_current_spread_display_value	character
home_team_odds_current_spread_fraction	character
home_team_odds_current_spread_value	double
home_team_odds_favorite	logical	Home team's team odds favorite.
home_team_odds_money_line	integer	Home team's team odds money line.
home_team_odds_open_favorite	logical
home_team_odds_open_money_line_alternate_display_value	character
home_team_odds_open_money_line_american	character
home_team_odds_open_money_line_decimal	double
home_team_odds_open_money_line_display_value	character
home_team_odds_open_money_line_fraction	character
home_team_odds_open_money_line_value	double
home_team_odds_open_point_spread_alternate_display_value	character
home_team_odds_open_point_spread_american	character
home_team_odds_open_point_spread_decimal	double
home_team_odds_open_point_spread_display_value	character
home_team_odds_open_point_spread_fraction	character
home_team_odds_open_point_spread_value	double
home_team_odds_open_spread_alternate_display_value	character
home_team_odds_open_spread_american	character
home_team_odds_open_spread_decimal	double
home_team_odds_open_spread_display_value	character
home_team_odds_open_spread_fraction	character
home_team_odds_open_spread_value	double
home_team_odds_spread_odds	double	Home team's team odds spread odds.
home_team_odds_team_$ref	character
home_team_odds_underdog	logical	Home team's team odds underdog.
open_over_alternate_display_value	character
open_over_american	character
open_over_decimal	double
open_over_display_value	character
open_over_fraction	character
open_over_value	double
open_total_alternate_display_value	character
open_total_american	character
open_total_decimal	double
open_total_display_value	character
open_total_fraction	character
open_total_value	double
open_under_alternate_display_value	character
open_under_american	character
open_under_decimal	double
open_under_display_value	character
open_under_fraction	character
open_under_value	double
provider_$ref	character
provider_id	character	Unique identifier for provider.
provider_name	character	Provider name.
provider_priority	integer	Provider priority.
prop_bets_$ref	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_odds(event_id='401584793')

Last validated n/a.

espn_mlb_game_probabilities

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/probabilities

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/probabilities?limit=300

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.
limit	limit			Y	Maximum number of items to return.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
away_win_percentage	double	Away team win probability (0-1 decimal).
home_win_percentage	double	Home team win probability (0-1 decimal).
last_modified	character	Last modified.
sequence_number	character	Sequence number of the play within the game.
spread_cover_prob_home	double
spread_push_prob	double
tie_percentage	double	Tie probability (0-1 decimal; extra-innings tie state).
total_over_prob	double
away_team_$ref	character
competition_$ref	character
home_team_$ref	character
play_$ref	character
source_description	character	Source description.
source_id	character	Source id.
source_state	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_probabilities(event_id='401584793')

Last validated n/a.

espn_mlb_game_plays

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/plays

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/plays?limit=1000

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.
limit	limit			Y	Maximum number of items to return.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
alternative_text	character
away_score	integer	Away team run total after the play.
clock_display_value	character
clock_value	double
coordinate_x	integer	Coordinate x.
coordinate_y	integer	Coordinate y.
home_score	integer	Home team run total after the play.
id	character	Id.
modified	character
period_display_value	character	Inning display value (e.g. 'Top 1st').
period_number	integer	Inning number.
points_attempted	integer
priority	logical
probability_$ref	character
score_value	integer	Runs scored on the play.
scoring_play	logical	TRUE if the play scored a run.
sequence_number	character	Sequence number of the play within the game.
shooting_play	logical	Shooting play.
team_$ref	character
text	character	Text description of the play.
type_id	character	Type id.
type_text	character	Type text.
valid	logical	Valid.
wallclock	character	Wall-clock timestamp of the play (ISO 8601).
short_alternative_text	character
short_text	character	Short text.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_plays(event_id='401584793')

Last validated n/a.

espn_mlb_game_play

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/plays/{play_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/plays/1

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
play_id	play_id		Y		play_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
alternative_text	character
away_score	integer	Away team run total after the play.
home_score	integer	Home team run total after the play.
id	character	Id.
modified	character
participants	character	List of athlete participants in the play.
points_attempted	integer
priority	logical
score_value	integer	Runs scored on the play.
scoring_play	logical	TRUE if the play scored a run.
sequence_number	character	Sequence number of the play within the game.
shooting_play	logical	Shooting play.
text	character	Text description of the play.
valid	logical	Valid.
wallclock	character	Wall-clock timestamp of the play (ISO 8601).
clock_display_value	character
clock_value	double
coordinate_x	integer	Coordinate x.
coordinate_y	integer	Coordinate y.
period_display_value	character	Inning display value (e.g. 'Top 1st').
period_number	integer	Inning number.
probability_$ref	character
team_$ref	character
type_id	character	Type id.
type_text	character	Type text.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_play(event_id='401584793', play_id='1')

Last validated n/a.

espn_mlb_game_play_personnel

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/plays/{play_id}/personnel

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/plays/1/personnel

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
play_id	play_id		Y		play_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: parser: parse_items returns no columns on the live payload (nba, 2026-10-07); its rows sit under keys it does not read (top level: $ref, playPersonnel).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_play_personnel(event_id='401584793', play_id='1')

Last validated n/a.

espn_mlb_game_situation

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/situation

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/situation

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
away_fouls_bonus_state	character
away_fouls_fouls_to_give	integer
away_fouls_team_fouls	integer
away_fouls_team_fouls_current	integer
away_timeouts_timeouts_current	integer
away_timeouts_timeouts_remaining_current	integer
home_fouls_bonus_state	character
home_fouls_fouls_to_give	integer
home_fouls_team_fouls	integer
home_fouls_team_fouls_current	integer
home_timeouts_timeouts_current	integer
home_timeouts_timeouts_remaining_current	integer
last_play_$ref	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_situation(event_id='401584793')

Last validated n/a.

espn_mlb_game_status

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/status

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/status

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
clock	double	Game clock value (typically empty for baseball).
display_clock	character
period	integer	Inning number.
type_completed	logical
type_description	character
type_detail	character
type_id	character	Type id.
type_name	character	Type name.
type_short_detail	character
type_state	character	Type state.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_status(event_id='401584793')

Last validated n/a.

espn_mlb_game_officials

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/officials

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/officials

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
display_name	character	Display name.
first_name	character	Player first name.
full_name	character	Player's full name.
id	character	Id.
last_name	character	Player last name.
order	integer	Order.
position_display_name	character	Position display name.
position_id	character	Unique position identifier.
position_name	character	Position name.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_officials(event_id='401584793')

Last validated n/a.

espn_mlb_game_broadcasts

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/broadcasts

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/broadcasts

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
channel	integer
lang	character
partnered	logical
priority	integer
region	character	Region label.
slug	character	URL-safe identifier.
station	character
competition_$ref	character
market_id	character	ESPN futures-market identifier.
market_type	character	Market type code (winLeague, winConference, winDivision, ...).
media_$ref	character
media_call_letters	character
media_id	character	Media identifier.
media_logos	character
media_name	character
media_short_name	character
media_slug	character
type_id	character	Type id.
type_long_name	character
type_short_name	character
type_slug	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_broadcasts(event_id='401584793')

Last validated n/a.

espn_mlb_game_predictor

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/predictor

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/predictor

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
last_modified	character	Last modified.
name	character	Display name.
short_name	character	Short display name.
away_team_statistics	character
away_team_team_$ref	character
home_team_team_$ref	character

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_predictor(event_id='401584793')

Last validated n/a.

espn_mlb_game_powerindex

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/powerindex

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/powerindex

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
count	integer	Count of count.
items	character
page_count	integer
page_index	integer
page_size	integer

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_powerindex(event_id='401584793')

Last validated n/a.

espn_mlb_game_propbets

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/propbets

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/propbets

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_propbets(event_id='401584793')

Last validated n/a.

espn_mlb_game_leaders

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/leaders

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/leaders

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nfl, mlb, nhl, wnba, cfb, mbb, wbb; 400 in nba with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_leaders(event_id='401584793')

Last validated n/a.

espn_mlb_game_scoringplays

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/scoringplays

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/scoringplays

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_scoringplays(event_id='401584793')

Last validated n/a.

espn_mlb_game_official_detail

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/{event_id}/competitions/{cid}/officials/{official_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/events/401584793/competitions/401584793/officials/1

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.
official_id	official_id		Y		official_id path parameter.
cid	cid			Y	cid path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
$ref	character
display_name	character	Display name.
first_name	character	Player first name.
full_name	character	Player's full name.
id	character	Id.
last_name	character	Player last name.
order	integer	Order.
position_display_name	character	Position display name.
position_id	character	Unique position identifier.
position_name	character	Position name.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mlb_game_official_detail(event_id='401584793', official_id='1')

Last validated n/a.