MLB — MLB Stats API — Schedule
mlb_schedule_postseason
GET /api/v1/schedule/postseason — postseason-only schedule for a season.
Endpoint URL: GET https://statsapi.mlb.com/api/v1/schedule/postseason
Valid URL: https://statsapi.mlb.com/api/v1/schedule/postseason
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | Season year (e.g. 2024). | ||
sportId | sport_id | Y | sportId query parameter. | ||
hydrate | hydrate | Y | hydrate query 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 |
|---|---|---|
schedule_date | character | The calendar date grouping postseason games in this response row, as returned by the MLB Stats API schedule endpoint. |
game_pk | integer | Unique game identifier. |
game_guid | character | Globally unique game identifier (GUID). |
link | character | API link to the game feed. |
game_type | character | Game type code (R, P, etc.). |
season | character | Season year. |
game_date | character | Game date (YYYY-MM-DD). |
official_date | character | Official game date (YYYY-MM-DD). |
is_tie | logical | Whether the game ended in a tie. |
is_featured_game | logical | Whether the game is a featured game. |
game_number | integer | Game number within a doubleheader. |
public_facing | logical | Whether the game is public-facing. |
double_header | character | Doubleheader indicator ('N', 'S', 'Y'). |
gameday_type | character | Gameday data feed type. |
tiebreaker | character | Whether the game is a tiebreaker. |
calendar_event_id | character | Calendar event identifier. |
season_display | character | Display string for the season. |
day_night | character | Day or night game indicator. |
description | character | Long-form description text. |
scheduled_innings | integer | Scheduled number of innings. |
reverse_home_away_status | logical | Whether home/away teams are reversed. |
inning_break_length | integer | Length of inning breaks in seconds. |
games_in_series | integer | Number of games in the series. |
series_game_number | integer | Game number within the series. |
series_description | character | Description of the series. |
record_source | character | Source of the schedule record. |
if_necessary | character | Whether the game is played only if necessary. |
if_necessary_description | character | Description of the if-necessary status. |
status_abstract_game_state | character | Abstract game state (e.g. 'Final'). |
status_coded_game_state | character | Coded game state. |
status_detailed_state | character | Detailed game state. |
status_status_code | character | Status code for the game. |
status_start_time_tbd | logical | Whether the start time is TBD. |
status_abstract_game_code | character | Abstract game state code. |
teams_away_team_id | integer | Away team MLBAM ID. |
teams_away_team_name | character | Away team name. |
teams_away_team_link | character | API link to the away team. |
teams_away_league_record_wins | integer | Away team league-record wins. |
teams_away_league_record_losses | integer | Away team league-record losses. |
teams_away_league_record_ties | integer | Away team league-record ties. |
teams_away_league_record_pct | character | Away team winning percentage. |
teams_away_score | integer | Away team score. |
teams_away_is_winner | logical | Whether the away team won. |
teams_away_split_squad | logical | Whether the away team is a split squad. |
teams_away_series_number | integer | Away team's series number. |
teams_home_team_id | integer | Home team MLBAM ID. |
teams_home_team_name | character | Home team name. |
teams_home_team_link | character | API link to the home team. |
teams_home_league_record_wins | integer | Home team league-record wins. |
teams_home_league_record_losses | integer | Home team league-record losses. |
teams_home_league_record_ties | integer | Home team league-record ties. |
teams_home_league_record_pct | character | Home team winning percentage. |
teams_home_score | integer | Home team score. |
teams_home_is_winner | logical | Whether the home team won. |
teams_home_split_squad | logical | Whether the home team is a split squad. |
teams_home_series_number | integer | Home team's series number. |
venue_id | integer | MLBAM venue ID. |
venue_name | character | Venue name. |
venue_link | character | API link to the venue. |
content_link | character | API link to the game content. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_schedule_postseason()
Last validated n/a.
mlb_schedule_tied
View tied game schedule info.
Endpoint URL: GET https://statsapi.mlb.com/api/v1/schedule/games/tied
Valid URL: https://statsapi.mlb.com/api/v1/schedule/games/tied?season=2016
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameTypes | game_types | Y | gameTypes query parameter. | ||
season | season | Y | Season year (e.g. 2024). | ||
hydrate | hydrate | Y | hydrate query parameter. | ||
fields | fields | Y | fields query 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 |
|---|---|---|
schedule_date | character | The calendar date grouping tied (suspended and resumed) games in this response row, as returned by the MLB Stats API schedule endpoint. |
game_pk | integer | Unique game identifier. |
game_guid | character | Globally unique game identifier (GUID). |
link | character | API link to the game feed. |
game_type | character | Game type code (R, P, etc.). |
season | character | Season year. |
game_date | character | Game date (YYYY-MM-DD). |
official_date | character | Official game date (YYYY-MM-DD). |
is_tie | logical | Whether the game ended in a tie. |
game_number | integer | Game number within a doubleheader. |
public_facing | logical | Whether the game is public-facing. |
double_header | character | Doubleheader indicator ('N', 'S', 'Y'). |
gameday_type | character | Gameday data feed type. |
tiebreaker | character | Whether the game is a tiebreaker. |
calendar_event_id | character | Calendar event identifier. |
season_display | character | Display string for the season. |
day_night | character | Day or night game indicator. |
scheduled_innings | integer | Scheduled number of innings. |
reverse_home_away_status | logical | Whether home/away teams are reversed. |
inning_break_length | integer | Length of inning breaks in seconds. |
games_in_series | integer | Number of games in the series. |
series_game_number | integer | Game number within the series. |
series_description | character | Description of the series. |
record_source | character | Source of the schedule record. |
if_necessary | character | Whether the game is played only if necessary. |
if_necessary_description | character | Description of the if-necessary status. |
status_abstract_game_state | character | Abstract game state (e.g. 'Final'). |
status_coded_game_state | character | Coded game state. |
status_detailed_state | character | Detailed game state. |
status_status_code | character | Status code for the game. |
status_start_time_tbd | logical | Whether the start time is TBD. |
status_reason | character | Reason for the game status (e.g. 'Rain'). |
status_abstract_game_code | character | Abstract game state code. |
teams_away_team_id | integer | Away team MLBAM ID. |
teams_away_team_name | character | Away team name. |
teams_away_team_link | character | API link to the away team. |
teams_away_league_record_wins | integer | Away team league-record wins. |
teams_away_league_record_losses | integer | Away team league-record losses. |
teams_away_league_record_ties | integer | Away team league-record ties. |
teams_away_league_record_pct | character | Away team winning percentage. |
teams_away_score | integer | Away team score. |
teams_away_split_squad | logical | Whether the away team is a split squad. |
teams_away_series_number | integer | Away team's series number. |
teams_home_team_id | integer | Home team MLBAM ID. |
teams_home_team_name | character | Home team name. |
teams_home_team_link | character | API link to the home team. |
teams_home_league_record_wins | integer | Home team league-record wins. |
teams_home_league_record_losses | integer | Home team league-record losses. |
teams_home_league_record_ties | integer | Home team league-record ties. |
teams_home_league_record_pct | character | Home team winning percentage. |
teams_home_score | integer | Home team score. |
teams_home_split_squad | logical | Whether the home team is a split squad. |
teams_home_series_number | integer | Home team's series number. |
venue_id | integer | MLBAM venue ID. |
venue_name | character | Venue name. |
venue_link | character | API link to the venue. |
content_link | character | API link to the game content. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_schedule_tied(season='2016')
Last validated n/a.
mlb_schedule_postseason_series
View schedule info for postseason based on series.
Endpoint URL: GET https://statsapi.mlb.com/api/v1/schedule/postseason/series
Valid URL: https://statsapi.mlb.com/api/v1/schedule/postseason/series?season=2023
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameTypes | game_types | Y | gameTypes query parameter. | ||
seriesNumber | series_number | Y | seriesNumber query parameter. | ||
teamId | team_id | Y | teamId query parameter. | ||
sportId | sport_id | Y | sportId query parameter. | ||
season | season | Y | Season year (e.g. 2024). | ||
fields | fields | Y | fields query 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 |
|---|---|---|
total_items | integer | Total schedule items on the date. |
total_games | integer | Total games on the date. |
total_games_in_progress | integer | Games currently in progress on the date. |
games | character | Games played. |
sort_order | integer | Display sort order for the sport. |
series_id | character | Series identifier (e.g. 'W_1'). |
series_sort_number | integer | Sort number for the series. |
series_is_default | logical | Whether the series is the default series. |
series_game_type | character | Game type code for the series. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_schedule_postseason_series(season='2023')
Last validated n/a.
mlb_schedule_postseason_tunein
View schedule info for the tuneIn application.
Endpoint URL: GET https://statsapi.mlb.com/api/v1/schedule/postseason/tuneIn
Valid URL: https://statsapi.mlb.com/api/v1/schedule/postseason/tuneIn?season=2023
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
teamId | team_id | Y | teamId query parameter. | ||
sportId | sport_id | Y | sportId query parameter. | ||
season | season | Y | Season year (e.g. 2024). | ||
hydrate | hydrate | Y | hydrate query parameter. | ||
fields | fields | Y | fields query parameter. |
Returns
return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_mlb_api_schedule); pass return_as_pandas=True for a pandas.DataFrame.
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_schedule_postseason_tunein(season='2023')
Last validated n/a.