Timeline Probabilities

⏱️
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 ex. `ENG` (England)
`id`	`sport_event_context` - `category`	String	Unique category ID for a sport event ex. `sr:category:1`
`name`	`sport_event_context` - `category`	String	Name for a sport event's category ex. `England` (Premier League)
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a sport event ex. `sr:sport:1`
`name`	`sport_event_context` - `sport`	String	Name for a sport event's sport ex. `Soccer`

Competition:

Attribute	Parent Element	Type	Description
`gender`	`sport_event_context` - `competition`	String	Gender for a competition ex. `men`
`id`	`sport_event_context` - `competition`	String	Unique ID for a competition ex. `sr:competition:17` (Premier League)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `Premier League`
`parent_id`	`sport_event_context` - `competition`	String	Unique parent ID for a competition. Typically present for group stage or playoff competitions ex. `sr:competition:945` used to link competitions together, like the World Cup and the various qualifiers.

Groups, Rounds, Seasons, & Stages:

Attribute	Parent Element	Type	Description
`id`	`sport_event_context` - `groups` - `group`	String	Unique ID for a sport event's group ex. `sr:league:80253` (UEFA Euro 2024, Group D)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `UEFA Euro 2024, Group D`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `D`
`competition_sport_event_number`	`sport_event_context` - `round`	Integer	Sport event number within a competition. Used for competitions that have fixed match numbers (World Cup)
`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. `round_3` or `round_of_16`
`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`
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a sport event belongs to ex. `sr:competition:17` (Premier League)
`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 sport event's season ex. `2024-05-19`
`id`	`sport_event_context` - `season`	String	Unique ID for a sport event's season ex. `sr:season:105353` (Premier League 23/24)
`name`	`sport_event_context` - `season`	String	Name of a sport event's season ex. `Premier League 23/24`
`start_date`	`sport_event_context` - `season`	Date	Start date of a sport event's season ex. `2023-08-11`
`year`	`sport_event_context` - `season`	String	Year of a sport event's season ex. `23/24`
`end_date`	`sport_event_context` - `stage`	Date	End date of a sport event's stage ex. `2024-05-19`
`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`, `preliminary_round`, `qualification`
`start_date`	`sport_event_context` - `stage`	Date	Start date of a sport event's stage ex. `2023-08-11`
`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`

Competitor:

Competitor information appears in the competitors node under both sport_event and statistics

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

Player:

Attribute	Parent Element	Type	Description
`id`	`statistics` - `competitor` - `player`	String	Unique ID of a player ex. `sr:player:159665`
`name`	`statistics` - `competitor` - `player`	String	Name of a player ex. `Salah, Mohamed`
`starter`	`statistics` - `competitor` - `player`	Boolean	Signifies a player is in the starting lineup for a sport event when `true`

Sport Event:

Attribute	Parent Element	Type	Description
`count`	`sport_event_conditions` - `attendance`	Integer	Attendance for a sport event ex. `25078`
`neutral`	`sport_event_conditions` - `ground`	Boolean	Signifies a neutral ground sport event when `true`
`confirmed`	`sport_event_conditions` - `lineups`	Boolean	Signifies lineups for a sport event have been confirmed when `true`
`id`	`sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:47395897`
`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`
`overall_conditions`	`sport_event_conditions` - `weather`	String	Weather conditions for a sport event `good`, `medium`, `bad`, `indoor`, `extreme`
`pitch_conditions`	`sport_event_conditions` - `weather`	String	Pitch conditions for a sport event `good`, `medium`, `bad`

Sport Event - Channel:

Attribute	Parent Element	Type	Description
`country`	`sport_event` - `channels` - `channel`	String	Country of a broadcast channel ex. `United States`
`country_code`	`sport_event` - `channels` - `channel`	String	Country code of a broadcast channel ex. `USA`
`name`	`sport_event` - `channels` - `channel`	String	Name of a broadcast channel ex. `Fox Soccer Plus`
`url`	`sport_event` - `channels` - `channel`	String	URL of a broadcast channel

Sport Event - Referee:

Attribute	Parent Element	Type	Description
`id`	`sport_event_conditions` - `referees` - `referee`	String	Unique ID for a referee ex. `sr:referee:229470`
`name`	`sport_event_conditions` - `referees` - `referee`	String	Name of a referee ex. `Brooks, John`
`nationality`	`sport_event_conditions` - `referees` - `referee`	String	Nationality of a referee ex. `England`
`country_code`	`sport_event_conditions` - `referees` - `referee`	String	Country code of a referee ex. `ENG`
`type`	`sport_event_conditions` - `referees` - `referee`	String	Type of a referee ex. `first_assistant_referee`, `second_assistant_referee`, `fourth_official`, `video_assistant_referee`, `first_additional_assistant`, `second_additional_assistant`, `main_referee`

Sport Event - Coverage Properties:

Attribute	Parent Element	Type	Description
`type`	`sport_event` - `coverage`	String	Type of coverage `sport_event`, `group`, `competition`
`ballspotting`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies ballspotting is available for a sport event when `true`
`basic_play_by_play`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies basic play-by-play is available for a sport event when `true`
`basic_player_stats`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies basic player stats is available for a sport event when `true`
`basic_team_stats`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies basic team stats is available for a sport event when `true`
`commentary`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies commentary is available for a sport event when `true`
`deeper_play_by_play`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies deeper play-by-play is available for a sport event when `true`
`deeper_player_stats`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies deeper player stats is available for a sport event when `true`
`deeper_team_stats`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies deeper team stats is available for a sport event when `true`
`extended_player_stats`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies extended player stats is available for a sport event when `true`
`extended_team_stats`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies extended team stats is available for a sport event when `true`
`fun_facts`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies fun facts are available for a sport event when `true`
`game_clock`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies the game glock is available for a sport event when `true`
`goal_scorers`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies goal scorers are available for a sport event when `true`
`lineups`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies goal lineups are available for a sport event when `true`
`lineups_availability`	`sport_event` - `coverage` - `sport_event_properties`	String	Describes the availability of lineups as pre-match or post-match `pre`, `post`
`probabilities`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies probabilities are available for a sport event when `true`
`scores`	`sport_event` - `coverage` - `sport_event_properties`	String	Describes the availability of scores as live or post-match `live`, `post`
`venue`	`sport_event` - `coverage` - `sport_event_properties`	Boolean	Signifies venue info is available for a sport event when `true`

Match Probabilities:

Attribute	Parent Element	Type	Description
`away_score`	`market`	Integer	Score for the away team
`home_score`	`market`	Integer	Score for the home team
`last_updated`	`market`	Date-time	Timestamp of the most recent probability update ex. `2024-04-23T19:22:59+00:00`
`live`	`market`	Boolean	Signifies that the match is live for this market when `true`
`match_time`	`market`	String	Clock value of a match in minutes and seconds ex. `22:50`
`name`	`market`	String	Probability market (2-way, 3-way, or to qualify) `2way`, `3way` `to_qualify`
`remaining_time`	`market`	String	Remaining time in a match Not currently in use
`remaining_time_in_period`	`market`	String	Remaining time in a period Not currently in use
`removed`	`market`	Boolean	Signifies a market has been removed when `true`
`name`	`market` - `outcome`	String	Probability market outcome `home_team_winner`, `away_team_winner`, `draw`
`probability`	`market` - `outcome`	Float	Probability of the market outcome (home win, away win, draw) in percentage ex. `36.1`

Match Stats (Player):

Attribute	Parent Element	Type	Description
`assists`	`player` - `statistics`	Integer	Player assists for a match
`corner_kicks`	`player` - `statistics`	Integer	Player corner kicks for a match
`goals_scored`	`player` - `statistics`	Integer	Player goals scored for a match
`offsides`	`player` - `statistics`	Integer	Player offsides for a match
`own_goals`	`player` - `statistics`	Integer	Player own goals for a match
`penalties_missed`	`player` - `statistics`	Integer	Player penalty shots missed for a match
`red_cards`	`player` - `statistics`	Integer	Player red cards for a match
`shots_blocked`	`player` - `statistics`	Integer	Player shots blocked for a match
`shots_off_target`	`player` - `statistics`	Integer	Player shots off target for a match
`shots_on_target`	`player` - `statistics`	Integer	Player shots on target for a match
`substituted_in`	`player` - `statistics`	Integer	Signifies a player was substituted in during a match when `1`
`substituted_out`	`player` - `statistics`	Integer	Signifies a player was substituted out during a match when `1`
`yellow_cards`	`player` - `statistics`	Integer	Player yellow cards for a match
`yellow_red_cards`	`player` - `statistics`	Integer	Player red cards for a match resulting from two yellow cards

Match Stats (Team):

Attribute	Parent Element	Type	Description
`ball_posession`	`competitor` - `statistics`	Integer	Percentage of team ball possession for a match. ex. `43`
`cards_given`	`competitor` - `statistics`	Integer	Total cards given to a team in a match
`corner_kicks`	`competitor` - `statistics`	Integer	Total team corner kicks for a match
`fouls`	`competitor` - `statistics`	Integer	Total number of fouls awarded against a team (including those which draw cards)
`free_kicks`	`competitor` - `statistics`	Integer	Team free kicks for a match. In accordance with the rules, a free kick stat counted for the team who executes a free kick. Direct or indirect free kicks are all counted as free kicks.
`goal_kicks`	`competitor` - `statistics`	Integer	Team goal kicks for a match. Total number of kicks awarded to the team as a result of the ball traveling out of bounds over the goal line of the defending team.
`injuries`	`competitor` - `statistics`	Integer	Total team injuries for a match
`offsides`	`competitor` - `statistics`	Integer	Total team offside infringements for a match
`penalties_missed`	`competitor` - `statistics`	Integer	Total team penalty shots missed for a match
`red_cards`	`competitor` - `statistics`	Integer	Total team red cards for a match
`shots_blocked`	`competitor` - `statistics`	Integer	Total team shots blocked for a match
`shots_off_target`	`competitor` - `statistics`	Integer	Total team off-target shots for a match
`shots_on_target`	`competitor` - `statistics`	Integer	Total team on-target shots for a match
`shots_saved`	`competitor` - `statistics`	Integer	Total number of goal keeper saves attributed to a team for a match
`shots_total`	`competitor` - `statistics`	Integer	Total number of shots attributed to a team for a match
`substitutions`	`competitor` - `statistics`	Integer	Total number player subsitutions in a match
`throw_ins`	`competitor` - `statistics`	Integer	Total number of throw-in events for a team during a match
`yellow_cards`	`competitor` - `statistics`	Integer	Total team yellow cards for a match
`yellow_red_cards`	`competitor` - `statistics`	Integer	Total team red cards for a match which resulted from two yellow cards

Venue:

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a competitor's home venue ex. `60000`
`changed`	`venue`	Boolean	Signifies a venue has been changed when `true`
`city_name`	`venue`	String	City name of a competitor's home venue ex. `Liverpool`
`country_code`	`venue`	String	Country code of a competitor's home venue ex. `ENG` (England)
`country_name`	`venue`	String	Country name of a competitor's home venue ex. `England`
`id`	`venue`	String	Unique ID of a competitor's home venue ex. `sr:venue:579`
`map_coordinates`	`venue`	String	Coordinates of a competitor's home venue ex. `53.430622,-2.960919`
`name`	`venue`	String	Name of a competitor's home venue ex. `Anfield`
`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 restrictued capacity
`timezone`	`venue`	String	Timezone of a competitor's home venue ex. `Europe/London`

⏱️Update Frequency

Data Points

⏱️
Update Frequency