get https://api.sportradar.com/soccer//v4//seasons//probabilities.
Provides 3-way win probabilities (home team win, away team win, draw) for all matches for a given season.
Update Frequency
60s Time To Live / Cache
Pagination Note
Pagination may be required to pull all data within this feed. By default, the feed will return 200 sport events.
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 stagecup , 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. 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 competitormale , 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 eventhome , away |
virtual | competitors - competitor | Boolean | Signifies a competitor is a virtual team whan true . Used for placeholder teams in TBD vs TBD matchups. |
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 eventgood , medium , bad , indoor , extreme |
pitch_conditions | sport_event_conditions - weather | String | Pitch conditions for a sport eventgood , 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 coveragesport_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-matchpre , 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-matchlive , 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 |
---|---|---|---|
name | market | String | Probability market (2-way or 3-way)2way , 3way |
name | market - outcome | String | Probability market outcomehome_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 |
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 |