Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Live Summaries

Provides game information for all currently live matches, including scoring.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

1s Time To Live / Cache


Data Points

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
Sport Event Status
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away competitor in a match
home_scoresport_event_statusIntegerTotal score for the home competitor in a match
match_statussport_event_statusStringStatus within a match (sport event). Provides more detail on the state of a match when live than status

ex. not_started, interrupted, 1st_set, walkover

See our Badminton OAS for a complete list of statuses.
scout_abandonedsport_event_statusBooleanSignifies a match was abandoned by a scout when true
statussport_event_statusStringStatus of a sport event

ex. not_started, live, ended, closed

See our FAQ for a complete list of statuses and their definitions.
winner_idsport_event_statusStringUnique ID of the match winner

ex. sr:competitor:174268
winning_reasonsport_event_statusStringWinning reason description for a match

ex. walkover
Period Scores
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway competitor set score
home_scoresport_event_status - period_scores - period_scoreIntegerHome competitor set score
numbersport_event_status - period_scores - period_scoreIntegerSet number
typesport_event_status - period_scores - period_scoreStringPeriod type

ex. set
Venue
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue

ex. 14820
changedvenueBooleanSignifies a venue has been changed when true
city_idvenueStringUnique ID of a city

ex. sr:city:59
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
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
required
Defaults to en

2-letter code for supported languages

en (English)

English is the only fully supported language for this API. Click here for valid language codes and a tabular list of available languages per competition.

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json