Sport Event Probabilities Timeline

get https://api.sportradar.com/probabilities/{access_level}/v1/{language_code}/sport_events/{sport_event_id}/timeline.{format}

Returns a list of probability changes during an event for a given sport event ID.

⏱️
Update Frequency
1s Time To Live / Cache

Data Points

Sport Event Probabilities:

Attribute	Parent Element	Type	Description
`away_score`	`timeline` - `market`	String	Total score for the away team in the sport event timeline entry
`home_score`	`timeline` - `market`	String	Total score for the home team in the sport event timeline entry
`last_updated`	`timeline` - `market`	Date-time	Timestamp of a probability timeline update ex. `2024-04-23T19:22:59+00:00`
`live`	`timeline` - `market`	Boolean	Signifies that the sport event for this market is currently in progress when `true`
`match_time`	`timeline` - `market`	String	Clock value of a sport event in minutes and seconds ex. `21:40`
`name`	`timeline` - `market`	String	Probability market ex. `2way`, `3way`, `home_innings_runs`, `away_innings_runs`
`remaining_time`	`timeline` - `market`	String	Remaining time in a sport event ex. `18:20`
`remaining_time_in_period`	`timeline` - `market`	String	Remaining time in a period ex. `8:20`
`removed`	`timeline` - `market`	Boolean	Signifies a market has been removed when `true`

Outcome:

Attribute	Parent Element	Type	Description
`name`	`timeline` - `market` - `outcome`	String	Name of a sport event probability market outcome ex. `home_team_winner`, `away_team_winner`, `draw`, `over`, `under`
`probability`	`timeline` - `market` - `outcome`	Float	Probability of the market outcome (home win, away win, draw) in percentage ex. `36.1`

Category & Sport:

Attribute	Parent Element	Type	Description
`country_code`	`sport_event_context` - `category`	String	Country code for a competition category ex. `FRA` (France)
`id`	`sport_event_context` - `category`	String	Unique category ID for a competition ex. `sr:category:110`
`name`	`sport_event_context` - `category`	String	Name for a competition category ex. `France`
`id`	`sport_event_context` - `sport`	String	Unique sport ID for a competitor ex. `sr:sport:2`
`name`	`sport_event_context` - `sport`	String	Name for a competitor's sport ex. `Basketball`

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:264` (Liga ACB)
`name`	`sport_event_context` - `competition`	String	Name of a competition ex. `Pro A`, `NBA`
`parent_id`	`sport_event_context` - `competition`	String	Unique parent ID for a competition. Typically present for group competitions ex. `sr:competition:30190` used to group NCAA basketball postseason 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:76103` (Euroleague 23/24)
`name`	`sport_event_context` - `groups` - `group`	String	Name of a sport event's group ex. `Euroleague 23/24`
`group_name`	`sport_event_context` - `groups` - `group`	String	Abbreviated name of a sport event's group ex. `D`

Rounds:

Attribute	Parent Element	Type	Description
`cup_round_id`	`sport_event_context` - `round`	String	Unique ID for a sport event's cup round ex. `sr:cup_round:1751367`
`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
`number`	`sport_event_context` - `round`	Integer	Number of a sport event's round

Seasons:

Attribute	Parent Element	Type	Description
`competition_id`	`sport_event_context` - `season`	String	Unique ID for the competition a sport event belongs to ex. `sr:competition:264` (Liga ACB)
`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-06-17`
`id`	`sport_event_context` - `season`	String	Unique ID for a sport event's season ex. `sr:season:108577` (Liga ACB 23/24)
`name`	`sport_event_context` - `season`	String	Name of a sport event's season ex. `Liga ACB 23/24`
`start_date`	`sport_event_context` - `season`	Date	Start date of a sport event's season ex. `2023-09-23`
`year`	`sport_event_context` - `season`	String	Year of a sport event's season ex. `23/24`

Stages:

Attribute	Parent Element	Type	Description
`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`, `playoffs` See the enum_phase entry in our Probabilities Open API 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. `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:

Attribute	Parent Element	Type	Description
`abbreviation`	`competitors` - `competitor`	String	Abbreviation for a competitor name ex. `RMA` (Real Madrid)
`country`	`competitors` - `competitor`	String	Country of a competitor ex. `Spain`
`country_code`	`competitors` - `competitor`	String	Country code of a competitor ex. `ESP` (Spain)
`division`	`competitors` - `competitor`	Integer	Division number for a competitor
`id`	`competitors` - `competitor`	String	Unique ID for a competitor ex. `sr:competitor:3540` (Real Madrid)
`name`	`competitors` - `competitor`	String	Name for a competitor ex. `Real Madrid`
`qualifier`	`competitors` - `competitor`	String	Designation of a competitor for a sport event `home`, `away`

Sport Event:

Attribute	Parent Element	Type	Description
`id`	`sport_event`	String	Unique ID of a sport event ex. `sr:sport_event:49796317`
`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`

Sport Event Status:

Attribute	Parent Element	Type	Description
`away_dismissals`	`sport_event_status`	Integer	Number of dismissals for the away team in the match (cricket)
`away_score`	`sport_event_status`	Integer	Total score for the away team in the match
`balls`	`sport_event_status`	Integer	Number of balls for the current batter in a game (baseball)
`bases`	`sport_event_status`	Integer	Current baserunners in a game (baseball) ex. `1,0,1` = runners on first base and third base
`delivery`	`sport_event_status`	Integer	Delivery number for a match (cricket)
`home_dismissals`	`sport_event_status`	Integer	Number of dismissals for the home team in the match (cricket)
`home_score`	`sport_event_status`	Integer	Total score for the home team in the match
`innings`	`sport_event_status`	Integer	Number of innings for a match (cricket)
`live`	`sport_event_status`	Boolean	Signifies live probabilities are available for a match when `true`
`match_status`	`sport_event_status`	String	Status within a match (sport event). Provides more detail on the state of a sport event when live than `status` ex. `not_started`, `1st_quarter`, `ended`, `cancelled`
`outs`	`sport_event_status`	Integer	Current number of outs for the game (baseball)
`over`	`sport_event_status`	Integer	Current over number for the match (cricket)
`position`	`sport_event_status`	Integer	Current yardline for the offensive team in a game (american football) ex. `58` (Opponent's 42 yardline)
`possession`	`sport_event_status`	Integer	Team with possession of the ball (american football) `1` (Home), `2` (Away)
`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.
`balls`	`sport_event_status`	Integer	Number of strikes for the current batter in a game (baseball)
`try`	`sport_event_status`	Integer	Current down number in a game (american football)
`winner_id`	`sport_event_status`	String	Unique ID of the match winner ex. `sr:competitor:44`
`yards`	`sport_event_status`	Integer	Current yards to go for a first down in a game (american football)

Venue:

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `15000`
`city_name`	`venue`	String	City name of a venue ex. `Madrid`
`country_code`	`venue`	String	Country code of a venue ex. `ESP` (Spain)
`country_name`	`venue`	String	Country name of a venue ex. `Spain`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:7000`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `40.423889,-3.671667`
`name`	`venue`	String	Name of a venue ex. `WiZink Center`
`timezone`	`venue`	String	Timezone of a venue ex. `Europe/Madrid`

Language

Credentials

Query

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