Live Timelines

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

Provides an event timeline for currently live matches.

⏱️
Update Frequency
1s Time To Live / Cache

Data Points

Sport Event:

Attribute	Parent Element	Type	Description
`id`	`sport_event_timeline`	String	Unique ID of a match ex. `sr:sport_event:49877723`
`start_time`	`sport_event_timeline`	Date	Start time of a match ex. `2024-03-26T20:00:00+00:00`

Sport Event Status:

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status`	Integer	Total score for the away competitor in a match
`home_score`	`sport_event_status`	Integer	Total score for the home competitor in a match
`match_status`	`sport_event_status`	String	Status within a match (sport event). Provides more detail on the state of a match when live than `status` ex. `not_started`, `interrupted`, `in_progress`, `ended` See our FAQ for a complete list of statuses and their definitions.
`scount_abandoned`	`sport_event_status`	Boolean	Signifies a match 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 match winner ex. `sr:competitor:120814`

Period Scores:

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away competitor period score
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home competitor period score
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Period number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Period type ex. `regular_period`, `snooker_session_break`

Match Timeline:

Attribute	Parent Element	Type	Description
`away_score`	`timeline` - `event`	Integer	Away competitor point score
`best_of_frames`	`timeline` - `event`	Integer	Provides the number of frames played for the match ex. `best_of="35"`
`break`	`timeline` - `event`	String	Display score for a competitor after a shot ex. `1:0`, `6:0`
`competitor`	`timeline` - `event`	String	Designation of a competitor for a timeline event `home`, `away`
`frame_number`	`timeline` - `event`	Integer	Frame number for a timeline event
`frame_score`	`timeline` - `event`	String	Total frame display score after a shot ex. `22:0`, `90:11`
`home_score`	`timeline` - `event`	Integer	Home competitor point score
`id`	`timeline` - `event`	Integer	Unique ID for a timeline event ex. `1692895333`
`lowest_value_color_available`	`timeline` - `event`	Integer	Lowest value ball color available after a shot ex. `2`, `7`
`number_of_red_balls`	`timeline` - `event`	Integer	Number of red balls for a match ex. `15`
`period_name`	`timeline` - `event`	String	Period name of a timeline event, appearing at the beginning of a period ex. `snooker_session_break`
`points`	`timeline` - `event`	Integer	Number of points recorded on a break
`red_balls_left`	`timeline` - `event`	Integer	Number of red balls left on the table after a shot ex. `10`
`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_info`, `break_off`, `match_started`, `match_ended`, `period_start`, `change_of_possession`, `ball_pot`, `score_change`, `foul`, `free_ball`, `re_rack`, `frame_started`, `frame_ended`

Language

Credentials

Query

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