Live Timelines

get https://api.sportradar.com/badminton/{access_level}/v2/{language_code}/competitors/live/timelines.{format}

Provides a play-by-play event timeline for currently live matches.

⏱️
Update Frequency
1s Time To Live / Cache

Data Points

Sport Event:

Attribute	Parent Element	Type	Description
`id`	`sport_event_timeline`	String	Unique ID of a match ex. `sr:sport_event:51847153`
`start_time`	`sport_event_timeline`	Date	Start time of a match ex. `2024-03-26T20:00:00+00:00`

Sport Event Status:

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status`	Integer	Total score for the away competitor in a match
`home_score`	`sport_event_status`	Integer	Total score for the home competitor in a match
`match_status`	`sport_event_status`	String	Status 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.
`scount_abandoned`	`sport_event_status`	Boolean	Signifies a match was abandoned by a scout when `true`
`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.
`winner_id`	`sport_event_status`	String	Unique ID of the match winner ex. `sr:competitor:174268`
`winning_reason`	`sport_event_status`	String	Winning reason description for a match ex. `walkover`

Period Scores:

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away competitor set score
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home competitor set score
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Set number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Period type ex. `set`

Match Timeline:

Attribute	Parent Element	Type	Description
`away_score`	`timeline` - `event`	Integer	Away competitor point score
`break_name`	`timeline` - `event`	String	Brief description of a break event ex. `break`
`competitor`	`timeline` - `event`	String	Designation of a competitor for a timeline event `home`, `away`
`home_score`	`timeline` - `event`	Integer	Home competitor point score
`id`	`timeline` - `event`	Integer	Unique ID for a timeline event ex. `1811218561`
`match_clock`	`timeline` - `event`	String	Clock value for a timeline event, in minutes and seconds ex. `70:17`
`period`	`timeline` - `event`	Integer	Set number of a timeline event. Populates for each `period_score` event.
`period_name`	`timeline` - `event`	String	Period name of a timeline event, appearing at the beginning of a period ex. `2nd_set`
`time`	`timeline` - `event`	Date-time	Timestamp of a timeline event ex. `2024-04-16T20:49:49+00:00`
`type`	`timeline` - `event`	String	Type of timeline event ex. `match_started`, `match_ended`, `period_start`, `break_start`, `score_change`, `period_score`

Language

Credentials

Header

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