Live Timelines

get https://api.sportradar.us/{sport}/{access_level}/v2/{language_code}/schedules/live/timelines.{format}

Global Baseball Live Timelines provides a play-by-play event timeline for currently live games.

⏱️
Update Frequency
1s Time To Live / Cache

Data Points

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.
`scount_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 Timeline:

Attribute	Parent Element	Type	Description
`id`	`sport_event_timeline`	String	Unique Id of a sport event ex. `sr:sport_event:46684149`
`start_time`	`sport_event_timeline`	Date-time	Start time of a sport event ex. `2024-04-23T18:15:00+00:00`
`away_score`	`timeline` - `event`	Integer	Score for the away team after a timeline event
`break_name`	`timeline` - `event`	String	Brief description of a break event ex. `break`
`competitor`	`timeline` - `event`	String	Designation of a competitor for a timeline event `home`, `away`
`home_score`	`timeline` - `event`	Integer	Score for the home team after a timeline event
`id`	`timeline` - `event`	Integer	Unique ID for a timeline event ex. `1793543391`
`match_clock`	`timeline` - `event`	String	Time elapsed in a game for a timeline event, in minutes and seconds ex. `94:41`
`match_time`	`timeline` - `event`	Integer	Time elapsed in a game for a timeline event, in minutes ex. `95`
`period`	`timeline` - `event`	Integer	Inning number of a timeline event
`period_name`	`timeline` - `event`	String	Name of an inning timeline event, appearing at the beginning of an inning ex. `1st_inning`
`time`	`timeline` - `event`	Date-time	Timestamp of a timeline event ex. `2024-04-16T20:49:49+00:00`
`type`	`timeline` - `event`	String	Type of timeline event ex. `match_started`, `match_ended`, `period_start`, `break_start`, `score_change`, `period_score`

Language

Authorization

Query

Click Try It! to start a request and see the response here!