Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Live Timelines

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

⏱️

Update Frequency

1s Time To Live / Cache



Data Points

Sport Event:
AttributeParent ElementTypeDescription
idsport_event_timelineStringUnique ID of a match
ex. sr:sport_event:46061651
start_timesport_event_timelineDateStart time of a match
ex. 2024-03-26T20:00:00+00:00
Sport Event Status:

Attribute

Parent Element

Type

Description

aggregate_away_score

sport_event_status

Integer

Aggregate score (of multiple events) for the away team

aggregate_home_score

sport_event_status

Integer

Aggregate score (of multiple events) for the home team

aggregate_winner_id

sport_event_status

String

Unique ID of the aggregate score winner
ex. sr:competitor:44

away_score

sport_event_status

Integer

Total score for the away team in a set

away_normaltime_score

sport_event_status

Integer

Number of sets won for the away team in a match

home_score

sport_event_status

Integer

Total score for the home team in a set

home_normaltime_score

sport_event_status

Integer

Number of sets won for the home team 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, 1st_set, awaiting_golden_set, ended

See our FAQ for a complete list of statuses and their definitions.

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:6709

Period Scores:
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway competitor period score
home_scoresport_event_status - period_scores - period_scoreIntegerHome competitor period score
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod type
ex. regular_period, overtime
Match Timeline:
AttributeParent ElementTypeDescription
away_scoretimeline - eventIntegerAway competitor point score
break_nametimeline - eventStringBrief description of a break event
ex. break
competitortimeline - eventStringDesignation of a competitor for a timeline event
home, away
home_scoretimeline - eventIntegerHome competitor point score
idtimeline - eventIntegerUnique ID for a timeline event
ex. 1692895333
periodtimeline - eventIntegerSet number of a timeline event. Populates for each period_score event.
period_nametimeline - eventStringPeriod name of a timeline event, appearing at the beginning of a period
ex. 1st_set
timetimeline - eventDate-timeTimestamp of a timeline event
ex. 2024-04-16T20:49:49+00:00
typetimeline - eventStringType of timeline event
ex. match_started, match_ended, period_start, break_start, score_change, period_score
Venue:
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue
ex. 12000
city_namevenueStringCity name of a venue
ex. Paris
country_codevenueStringCountry code of a venue
ex. FRA (France)
country_namevenueStringCountry name of a venue
ex. France
idvenueStringUnique ID of a venue
ex. sr:venue:78691
namevenueStringName of a venue
ex. South Paris Arena
timezonevenueStringTimezone of a venue
ex. Europe/Paris
Language
Credentials
Header
Click Try It! to start a request and see the response here!