Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Season Probabilities

Provides 2-way match win probabilities (home team win, away team win) for all matches in 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

Match Probabilities
AttributeParent ElementTypeDescription
namemarketStringProbability market

2way
namemarket - outcomeStringProbability market outcome

home_team_winner, away_team_winner
probabilitymarket - outcomeFloatProbability of the market outcome (home win, away win) in percentage

ex. 36.1
Category & Sport
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a sport event's category
idsport_event_context - categoryStringUnique category ID for a sport event

ex. sr:category:259 (International)
namesport_event_context - categoryStringName for a sport event's category

ex. International
idsport_event_context - sportStringUnique sport ID for a sport event

ex. sr:sport:31
namesport_event_context - sportStringName for a sport event's sport

ex. Badminton
Competition
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition

ex. men, women, mixed
idsport_event_context - competitionStringUnique ID for a competition

ex. sr:competition:41728 (Ruichang China Masters, MS)
namesport_event_context - competitionStringName of a competition

ex. Ruichang China Masters, MS, Toyota Thailand Open, Doubles
parent_idsport_event_context - competitionStringUnique parent ID for a competition.

ex. sr:competition:41726 is used to group all Ruichang China Masters competitions.
typesport_event_context - competitionStringType of a competition

ex. singles, doubles, mixed_doubles
Groups
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group

ex. sr:cup:161825 (French Open 2024, MD)
namesport_event_context - groups - groupStringName of a sport event's group

ex. French Open 2024, MD
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
Rounds
AttributeParent ElementTypeDescription
competition_sport_event_numbersport_event_context - roundIntegerSport event number within a competition. Used for competitions that have fixed match numbers.
cup_round_idsport_event_context - roundStringUnique ID for a sport event's cup round

ex. sr:cup_round:1751367
cup_round_number_of_sport_eventssport_event_context - roundIntegerNumber of events in a sport event's round
cup_round_sport_event_numbersport_event_context - roundIntegerNumber within the cup_round of a match ID. For example, 1st leg of 2
namesport_event_context - roundStringName of a match's round

ex. quarterfinal or final
numbersport_event_context - roundIntegerNumber of a match's round
other_sport_event_idsport_event_context - roundStringA linked sport event ID, typically in a two-legged tie

ex. sr:sport_event:47395897
Season
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a season belongs to

ex. sr:competition:559 (Olympic Tournament, Doubles)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a season

ex. 2025-07-13
idseasonStringUnique ID for a season

ex. sr:season:119999 (Olympic Tournament, Doubles 2024)
namesport_event_context - seasonStringName of a season

ex. Olympic Tournament, Doubles 2024
start_datesport_event_context - seasonDateStart date of a season

ex. 2025-06-23
yearsport_event_context - seasonStringYear of a season

ex. 24/25 or 2024
Stages
AttributeParent ElementTypeDescription
end_datesport_event_context - stageDateEnd date of a sport event's stage

ex. 2024-07-14
ordersport_event_context - stageIntegerOrder of a stage within a season
phasesport_event_context - stageStringName of a sport event's stage

ex. ms (men singles), md (men doubles), ws (women singles), wd (women doubles), xd (mixed doubles)

See the enum_phase entry in our Badminton OpenAPI spec for a complete list of valid phase enum values
start_datesport_event_context - stageDateStart date of a sport event's stage

ex. 2024-06-24
typesport_event_context - stageStringType of a match's stage

cup, league
yearsport_event_context - stageStringYear of a match's stage

ex. 23/24 or 2024
Competitor

Competitors can be a player or a doubles team

AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name (singles or doubles)

ex. SHI (Shi, Yu Qi), LIW (Liang W K / Wang C)
countrycompetitors - competitorStringCountry of a competitor

ex. China
country_codecompetitors - competitorStringCountry code of a competitor

ex. CHN
date_of_birthcompetitor - competitorDateDate of birth of a competitor

ex. 1996-02-28
gendercompetitors - competitorStringGender for a competitor

male, female
idcompetitors - competitorStringUnique ID for a competitor

ex. sr:competitor:164376
namecompetitors - competitorStringName for a competitor (singles or doubles)

ex. Shi, Yu Qi, Liang W K / Wang C
qualifiercompetitors - competitorStringDesignation of a competitor for a match

home, away
virtualcompetitors - competitorBooleanSignifies a competitor is virtual when true. Used for placeholder players/teams in TBD vs TBD matchups.
Player

Competitors will appear under a players node when part of a doubles competition.

AttributeParent ElementTypeDescription
abbreviationcompetitor - players - playerStringAbbreviation for a player name

ex. LIA (Liang, Wei Keng)
countrycompetitor - players - playerStringCountry of a competitor

ex. China
country_codecompetitor - players - playerStringCountry code of a competitor

ex. CHN
date_of_birthcompetitor - players - playerDateDate of birth of a player

ex. 1994-07-05
idcompetitor - players - playerStringUnique ID for a competitor

ex. sr:competitor:569895
namecompetitor - players - playerStringName for a competitor

ex. Liang, Wei Keng
Coverage Properties
AttributeParent ElementTypeDescription
livesport_event - coverageStringSignifies a sport event is covered live when true
Sport Event
AttributeParent ElementTypeDescription
idsport_eventStringUnique ID of a match

ex. sr:sport_event:50453019
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date

ex. sr:sport_event:51847153
resume_timesport_eventDateAn updated timestamp if there is a delay at the start or interruption during a match

ex. 2024-03-26T20:00:00+00:00
start_timesport_eventDateStart time of a match

ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a match is confirmed when true
Venue
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue

ex. 14820
changedvenueBooleanSignifies a venue has been changed when true
city_namevenueStringCity name of a venue

ex. Jakarta
country_codevenueStringCountry code of a venue

ex. IDN (England)
country_namevenueStringCountry name of a venue

ex. Indonesia
idvenueStringUnique ID of a venue

ex. sr:venue:76057
map_coordinatesvenueStringCoordinates of a venue

ex. 54.707924, 25.236942
namevenueStringName of a venue

ex. Court 1, Center Court, or Court 2
reduced_capacityvenueBooleanOptional attribute signifying a venue has a restricted capacity when true
reduced_capacity_maxvenueIntegerValue of a venue's restricted capacity
timezonevenueStringTimezone of a venue

ex. Asia/Jakarta
Language
Credentials
Header
Click Try It! to start a request and see the response here!