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.
Update FrequencyTTL / Cache: 480 seconds
Data Updates: As Necessary
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 |
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 |
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 |
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 |