get
https://api.sportradar.com/mlb//v8//games///schedule.
MLB League Schedule provides complete schedule information for a given season, including venue and broadcast info.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL / Cache: 4 hours
Data Updates: Schedule info updates in realtime as changes are made
Pulling SchedulesLearn how to retrieve the full season schedule and discover game IDs in our Pulling Schedules integration scenario.
Data Points
Boxscore
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
attendance | game | Integer | Attendance of a game |
abbr | away | String | Abbreviation of the away team ex. MIN (Minnesota) |
id | away | GUID | Unique ID of the away team ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b |
loss | away | Integer | Number of losses for the away team at the beginning of a game. Total will update if necessary once the game has completed. |
market | away | String | Market name of the away team ex. Colorado |
name | away | String | Team name of the away team ex. Rockies |
seed | away | Integer | Seed number for the away team |
win | away | Integer | Number of losses for the away team at the beginning of a game. Total will update if necessary once the game has completed. |
duration | game | String | Duration of a game in hours and minutes ex. 3:18 |
abbr | home | String | Abbreviation of the home team ex. CLE (Cleveland) |
id | home | GUID | Unique ID of the home team ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b |
loss | home | Integer | Number of losses for the home team at the beginning of a game. Total will update if necessary once the game has completed. |
market | home | String | Market name of the home team ex. Cleveland |
name | home | String | Team name of the home team ex. Guardians |
seed | home | Integer | Seed number for the home team |
win | home | Integer | Number of losses for the home team at the beginning of a game. Total will update if necessary once the game has completed. |
Game
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
away_team | game | GUID | Unique ID of the away team ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b |
coverage | game | String | Coverage level of a gamefull, boxscore |
deleted | game | Boolean | Signifies a game was deleted when true |
double_header | game | Boolean | Signifies whether a game is part of a double header |
day_night | game | String | Signifies a day or night gameD, N |
entry_mode | game | String | Signifies the type of data entrySTOMP, LDE |
gameday_type | game | String | Coverage level of a game defined as Premium, Enhanced, or RegularP - PremiumPitch tracking, player tracking, and full Statcast product experience E - EnhancedPitch tracking but not full Statcast product experience Y - RegularPitch-by-Pitch resulting but no Statcast product experience ex. gameday_type="E" |
home_team | game | GUID | Unique ID of the home team ex. ef64da7f-cfaf-4300-87b0-9313386b977c |
id | game | GUID | Unique ID of the game ex. 1b554f5e-d8b7-4268-95da-2f4191015c84 |
id | deleted_games - game | GUID | Unique ID of a deleted game ex. 1b554f5e-d8b7-4268-95da-2f4191015c84 |
game_number | game | Integer | Number of the game |
parent_id | game | GUID | Standard parent ID of a game or series. Use this ID to group events (like the World Series or All-Star Game) across seasons. ex. 34e4cbbe-0086-4fad-bb08-840cbcfcabf0 (All-Star Game) |
| - | rescheduled_from | dateTime | Original start date/time of a rescheduled game |
reason | rescheduled_from | String | Reason for a rescheduled game ex. postponed, suspended |
reference | game | String | Unique MLBAM ID of a game |
scheduled | game | dateTime | Scheduled date and time of a game ex. 2022-09-25T20:10:00+00:00 |
tbd | game | Boolean | Signifies the game start time is to be determined. Placeholder start time is 08:00:00+00:00 |
split_squad | game | Boolean | Signifies a Spring Training split squad game |
status | game | String | The status of a game. See our FAQ for all statuses and their definitions.scheduled, inprogress, complete, closed, wdelay, fdelay, odelay, canceled, unnecessary, if-necessary, postponed, suspended, maintenance |
Broadcast
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
channel | broadcasts - broadcast | String | Name of a game's broadcast channel ex. 213 |
locale | broadcasts - broadcast | String | Signifies the locale of a broadcast ex. Home, Away, National |
network | broadcasts - broadcast | String | Name of a game's broadcast network ex. MLB Network, NBCS-BA, ESPN |
type | broadcasts - broadcast | String | Type of broadcast ex. TV, Internet |
League
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | league | String | Alias of a league ex. MLB |
id | league | GUID | Unique ID of a league ex. 2fa448bc-fc17-4d3d-be03-e60e080fdc26 |
name | league | String | Name of a league ex. Major League Baseball |
id | season-schedule | GUID | Unique ID of a season ex. f5aa580e-8103-4ff5-beb0-965dbe8a8cf1 |
type | season-schedule | String | Type of seasonPRE(Spring Training), REG(Regular Season), PST(Postseason), AST(All-Star Game) |
year | season-schedule | Integer | Year of a season |
Series
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
ps_game | game | Integer | Game number in a series |
ps_round | game | String | Name of a series ex. ALDS |
Venue
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
address | venue | String | Address of a venue ex. 1000 Vin Scully Avenue |
capacity | venue | String | Capacity of a venue ex. 56000 |
city | venue | String | City of a venue ex. Los Angeles |
country | venue | String | Country of a venue ex. USA |
field_orientation | venue | String | Field orientation of a venue ex. NE |
id | venue | GUID | Unique ID of a venue ex. 66a19c3d-24fe-477d-bee7-c6ef1b98352f |
lat | location | Decimal | Latitude of a venue ex. 34.0745409 |
lng | location | Decimal | Longitude of a venue ex. -118.2408881 |
market | venue | String | Market of a venue ex. Los Angeles |
name | venue | String | Name of a venue ex. Dodger Stadium |
stadium_type | venue | String | Type of a venue ex. outdoor |
state | venue | String | State of a venue ex. CA |
surface | venue | String | Surface type of a venue ex. grass |
time_zone | venue | String | Time zone of a venue ex. US/Central |
zip | venue | Integer | ZIP code of a venue ex. 90012 |