Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

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:
AttributeParent ElementTypeDescription
away_scoresport_event_statusIntegerTotal score for the away team in a set
away_normaltime_scoresport_event_statusIntegerNumber of sets won for the away team in a match
home_scoresport_event_statusIntegerTotal score for the home team in a set
home_normaltime_scoresport_event_statusIntegerNumber of sets won for the home team 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, 1st_set, awaiting_golden_set, ended

See our FAQ for a complete list of statuses and their definitions.
scount_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: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
Query
Click Try It! to start a request and see the response here!