Live Summaries

get

https://api.sportradar.com/{sport}/{access_level}/v2/{language_code}/schedules/live/summaries.{format}

Global Baseball Live Summaries provides game information for all currently live games including team scoring, player and team game statistics. This feed updates in real time as games are played.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
1s Time To Live / Cache

Data Points

Category & Sport

Attribute	Parent Element	Type	Description
`country_code`	`sport_event_context` - `category`	String	Country code for a competition category ex. `JPN` (Japan)
`id`	`sport_event_context` - `category`	String	Unique category ID for a competition ex. `sr:category:211`
`name`	`sport_event_context` - `category`	String	Name for a competition category ex. `Japan`
`id`	`competitor_profile` - `sport`	String	Unique sport ID for a competitor ex. `sr:sport:3`
`name`	`competitor_profile` - `sport`	String	Name for a competitor's sport ex. `Baseball`

Competition

Attribute	Parent Element	Type	Description
`gender`	`sport_event_context` - `competition`	String	Gender for a competition `men`, `women`
`id`	`sport_event_context` - `competition`	String	Unique ID for a competition ex. `sr:competition:1036` (NPB)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `NPB`, `Italian Baseball League`
`parent_id`	`sport_event_context` - `competition`	String	Unique parent ID for a competition. Typically present for group competitions ex. `sr:competition:37221` used to group NCAA tournaments.

Groups

Attribute	Parent Element	Type	Description
`id`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:league:80925` (National League West)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `MLB 2024, National League West`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `National League West`

Rounds

Attribute	Parent Element	Type	Description
`competition_sport_event_number`	`sport_event_context` - `round`	Integer	Sport event number within a competition. Used for competitions that have fixed match numbers.
`cup_round_id`	`sport_event_context` - `round`	String	Unique ID for a sport event's cup round ex. `sr:cup_round:1988995`
`cup_round_number_of_sport_events`	`sport_event_context` - `round`	Integer	Number of events in a sport event's round
`cup_round_sport_event_number`	`sport_event_context` - `round`	Integer	Number within the `cup_round` of a match ID. For example, 1st leg of 2
`name`	`sport_event_context` - `round`	String	Name of a sport event's round ex. `quarterfinal` or `final`
`number`	`sport_event_context` - `round`	Integer	Number of a sport event's round
`other_sport_event_id`	`sport_event_context` - `round`	String	A linked sport event ID, typically in a two-legged tie ex. `sr:sport_event:47395897`

Seasons

Attribute	Parent Element	Type	Description
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:1036` (NPB 2024)
`disabled`	`sport_event_context` - `season`	Boolean	Signifies a season has been disabled when `true`
`end_date`	`sport_event_context` - `season`	Date	End date of a season ex. `2024-11-03`
`id`	`sport_event_context` - `season`	String	Unique ID for a season ex. `sr:season:99979` (World Baseball Classic 2023)
`name`	`sport_event_context` - `season`	String	Name of a season ex. `NPB 2024`
`start_date`	`sport_event_context` - `season`	Date	Start date of a season ex. `2024-03-29`
`year`	`sport_event_context` - `season`	String	Year of a season ex. `23/24` or `2024`

Stages

Attribute	Parent Element	Type	Description
`end_date`	`sport_event_context` - `stage`	Date	End date of a sport event's stage ex. `2024-10-01`
`order`	`sport_event_context` - `stage`	Integer	Order of a stage within a season
`phase`	`sport_event_context` - `stage`	String	Name of a sport event's stage ex. `regular season`, `conference`, `playoffs` See the enum_phase entry in our Global Baseball OpenAPI spec for a complete list of valid `phase` enum values
`start_date`	`sport_event_context` - `stage`	Date	Start date of a sport event's stage ex. `2024-03-20`
`type`	`sport_event_context` - `stage`	String	Type of a sport event's stage `cup`, `league`
`year`	`sport_event_context` - `stage`	String	Year of a sport event's stage ex. `23/24` or `2024`

Competitor

Attribute	Parent Element	Type	Description
`abbreviation`	`competitor`	String	Abbreviation for a competitor name ex. `LAD` (Los Angeles Dodgers)
`age_group`	`competitor`	String	Age group of a competitor, when applicable ex. `U23`
`country`	`competitor`	String	Country of a competitor ex. `Japan`
`country_code`	`competitor`	String	Country code of a competitor ex. `JPN` (Japan)
`gender`	`competitor`	String	Gender for a competitor `male`, `female`
`id`	`competitor`	String	Unique ID for a competitor ex. `sr:competitor:3638` (Los Angeles Dodgers)
`name`	`competitor`	String	Name for a competitor ex. `Los Angeles Dodgers`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a sport event `home`, `away`
`virtual`	`competitor`	Boolean	Signifies a competitor is a virtual team when `true`. Used for placeholder teams in TBD vs TBD matchups.

Coverage Properties

Attribute	Parent Element	Type	Description
`type`	`sport_event` - `coverage`	String	Type of coverage for a sport event `sport_event`, `competition`
`basic_play_by_play`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies basic play-by-play of a sport event is available when `true`
`scores`	`sport_event` - `coverage` - `sport_event_properties`	Strings	Indicates when sport event scores are made available `live`, `post` (Postgame)

Sport Event

Attribute	Parent Element	Type	Description
`id`	`sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:49796317`
`replaced_by`	`sport_event`	String	An alternative sport event ID if the match is postponed and played at a later date ex. `sr:sport_event:47395897`
`resume_time`	`sport_event`	Date	An updated timestamp if there is a delay at the start or interruption during a match ex. `2024-03-26T20:00:00+00:00`
`start_time`	`sport_event`	Date	Start time of a sport event ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies the start time of a sport event is confirmed when `true`

Period Scores

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away team inning score
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home team inning score
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Inning number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Inning type `started`, `overtime`, `overtime_break`, `break`, `interrupted`, `1st_inning`, `2nd_inning`, `3rd_inning`, `4th_inning`, `5th_inning`, `6th_inning`, `7th_inning`, `8th_inning`, `9th_inning`, `regular_period`

Sport Event Status

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status`	Integer	Total score for the away team in the game
`away_normaltime_score`	`sport_event_status`	Integer	Score for the away team in normal time (9 innings)
`home_score`	`sport_event_status`	Integer	Total score for the home team in the game
`home_normaltime_score`	`sport_event_status`	Integer	Score for the home team in normal time (9 innings)
`decided_inning`	`sport_event_status`	Integer	Final inning number of a game
`match_status`	`sport_event_status`	String	Status within a game (sport event). Provides more detail on the state of a sport event when live than `status` ex. `not_started`, `start_delayed`, `1st_inning`, `postponed` See our FAQ for a complete list of statuses and their definitions.
`scout_abandoned`	`sport_event_status`	Boolean	Signifies a game was abandoned by a scout when `true`
`status`	`sport_event_status`	String	Status of a sport event ex. `not_started`, `live`, `ended`, `closed` See our FAQ for a complete list of statuses and their definitions.
`winner_id`	`sport_event_status`	String	Unique ID of the game winner ex. `sr:competitor:3638`

Game Stats (Team)

Attribute	Parent Element	Type	Description
`at_bats`	`competitor` - `statistics`	Integer	Number of at bats for a team in a game
`earned_runs`	`competitor` - `statistics`	Integer	Number of earned runs allowed for a team in a game
`errors`	`competitor` - `statistics`	Integer	Number of errors committed by a team in a game
`hits`	`competitor` - `statistics`	Integer	Number of hits for a team in a game
`hits_allowed`	`competitor` - `statistics`	Integer	Number of hits allowed for a team in a game
`home_runs`	`competitor` - `statistics`	Integer	Number of home runs for a team in a game
`innings_pitched`	`competitor` - `statistics`	Integer	Number of innings pitched for a team in a game
`runs`	`competitor` - `statistics`	Integer	Number of runs scored for a team in a game
`runs_batted_in`	`competitor` - `statistics`	Integer	Number of runs batted in (RBIs) for a team in a game
`saves`	`competitor` - `statistics`	Integer	Number of saves for a team in a game
`stolen_bases`	`competitor` - `statistics`	Integer	Number of stolen bases for a team in a game
`walks`	`competitor` - `statistics`	Integer	Number of walks for a team in a game
`walks_allowed`	`competitor` - `statistics`	Integer	Number of walks allowed for a team in a game

Game Stats (Player)

Attribute	Parent Element	Type	Description
`at_bats`	`player` - `statistics`	Integer	Number of at bats for a player in a game
`earned_runs`	`player` - `statistics`	Integer	Number of earned runs allowed for a player in a game
`errors`	`player` - `statistics`	Integer	Number of errors committed by a player in a game
`hits`	`player` - `statistics`	Integer	Number of hits for a player in a game
`hits_allowed`	`player` - `statistics`	Integer	Number of hits allowed for a player in a game
`home_runs`	`player` - `statistics`	Integer	Number of home runs for a player in a game
`innings_pitched`	`player` - `statistics`	Integer	Number of innings pitched for a player in a game
`runs`	`player` - `statistics`	Integer	Number of runs scored for a player in a game
`runs_batted_in`	`player` - `statistics`	Integer	Number of runs batted in (RBIs) for a player in a game
`saves`	`player` - `statistics`	Integer	Number of saves for a player in a game
`stolen_bases`	`player` - `statistics`	Integer	Number of stolen bases for a player in a game
`walks`	`player` - `statistics`	Integer	Number of walks for a player in a game
`walks_allowed`	`player` - `statistics`	Integer	Number of walks allowed for a player in a game

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `56000`
`changed`	`venue`	Boolean	Signifies a venue has been changed when `true`
`city_id`	`venue`	String	Unique ID of a city ex. `sr:city:59`
`city_name`	`venue` String	City name of a venue ex. `Los Angeles`
`country_code`	`venue`	String	Country code of a venue ex. `USA`
`country_name`	`venue`	String	Country name of a venue ex. `USA`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:8117`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `34.0745409,-118.2408881`
`name`	`venue`	String	Name of a venue ex. `Dodger Stadium`
`reduced_capacity`	`venue`	Boolean	Optional attribute signifying a venue has a restricted capacity when `true`
`reduced_capacity_max`	`venue`	Integer	Value of a venue's restricted capacity
`timezone`	`venue`	String	Timezone of a venue ex. `America/Los_Angeles`

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json