Sport Event Timeline

⏱️
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 sport event's category
`id`	`sport_event_context` - `category`	String	Unique category ID for a sport event ex. `sr:category:55` (International)
`name`	`sport_event_context` - `category`	String	Name for a sport event's category ex. `International`
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a sport event ex. `sr:sport:19`
`name`	`sport_event_context` - `sport`	String	Name for a sport event's sport ex. `Snooker`

Competition:

Attribute	Parent Element	Type	Description
`gender`	`sport_event_context` - `competition`	String	Gender for a competition ex. `men`, `women`, `mixed`
`id`	`sport_event_context` - `competition`	String	Unique ID for a competition ex. `sr:competition:21248` (Northern Ireland Open)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `Northern Ireland Open`
`parent_id`	`sport_event_context` - `competition`	String	Unique parent ID for a competition ex. `sr:competition:14460`

Groups:

Attribute	Parent Element	Type	Description
`id`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:cup:163447` (World Championship 2024)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `World Championship 2024`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group

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.
`name`	`sport_event_context` - `round`	String	Name of a match's round ex. `round_of_16` or `final`
`number`	`sport_event_context` - `round`	Integer	Number of a match's round

Season:

Attribute	Parent Element	Type	Description
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a season belongs to ex. `sr:competition:430` (World Championship)
`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. `2025-07-13`
`id`	`season`	String	Unique ID for a season ex. `sr:season:104989` (World Championship 2024)
`name`	`sport_event_context` - `season`	String	Name of a season ex. `World Championship 2024`
`start_date`	`sport_event_context` - `season`	Date	Start date of a season ex. `2025-06-23`
`year`	`sport_event_context` - `season`	String	Year of a season ex. `24/25` 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-07-14`
`order`	`sport_event_context` - `stage`	Integer	Order of a stage within a season
`phase`	Name of a sport event's stage ex. `playoffs`, `regular season` See the enum_phase entry in our Snooker 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-06-24`
`type`	`sport_event_context` - `stage`	String	Type of a match's stage `cup`, `league`
`year`	`sport_event_context` - `stage`	String	Year of a match's stage ex. `23/24` or `2024`

Competitor:

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `JON` (Jones, Jak)
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:130248`
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Jones, Jak`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a match `home`, `away`

Coverage Properties:

Attribute	Parent Element	Type	Description
`live`	`sport_event` - `coverage`	String	Signifies a sport event is covered live when `true`

Sport Event:

Attribute	Parent Element	Type	Description
`id`	`sport_event`	String	Unique ID of a match ex. `sr:sport_event:48525429`
`best_of`	`sport_event_context` - `mode`	Integer	Provides the number of frames played for the match ex. `best_of="35"`
`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:51847153`
`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`
`resumed`	`sport_event`	Date	Timestamp of the resumed start of a match ex. `2024-03-26T20:00:00+00:00`
`start_time`	`sport_event`	Date	Start time of a match ex. `2024-03-26T20:00:00+00:00`
`start_time_confirmed`	`sport_event`	Boolean	Signifies the start time of a match is confirmed when `true`

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 Stats (Competitor):

Attribute	Parent Element	Type	Description
`balls_potted`	`competitor` - `statistics`	Integer	Number of balls potted for a competitor in a match
`black_balls_potted`	`competitor` - `statistics`	Integer	Number of black balls potted for a competitor in a match
`blue_balls_potted`	`competitor` - `statistics`	Integer	Number of blue balls potted for a competitor in a match
`breaks_100_plus`	`competitor` - `statistics`	Integer	Number of 100+ point breaks for a competitor in a match
`breaks_50_plus`	`competitor` - `statistics`	Integer	Number of 50+ point breaks for a competitor in a match
`brown_balls_potted`	`competitor` - `statistics`	Integer	Number of brown balls potted for a competitor in a match
`fouls_conceded`	`competitor` - `statistics`	Integer	Number of fouls conceded for a competitor in a match
`green_balls_potted`	`competitor` - `statistics`	Integer	Number of green balls potted for a competitor in a match
`highest_break`	`competitor` - `statistics`	Integer	Highest break number for a competitor in a match
`pink_balls_potted`	`competitor` - `statistics`	Integer	Number of pink balls potted for a competitor in a match
`points`	`competitor` - `statistics`	Integer	Number of total points for a competitor in a match
`red_balls_potted`	`competitor` - `statistics`	Integer	Number of red balls potted for a competitor in a match
`shots_taken`	`competitor` - `statistics`	Integer	Number of total shots taken for a competitor in a match
`time_on_table_percentage`	`competitor` - `statistics`	Double	Percentage of time on the table for a competitor in a match ex. `0.49958207083899`
`time_on_table_seconds`	`competitor` - `statistics`	Integer	Amount of time on the table in seconds for a competitor in a match
`yellow_balls_potted`	`competitor` - `statistics`	Integer	Number of yellow balls potted for a competitor in a match

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`

⏱️Update Frequency

Data Points

⏱️
Update Frequency