Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Live Timelines

Provides an event timeline for currently live matches.

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

Update Frequency

1s Time To Live / Cache


Data Points

Sport Event
AttributeParent ElementTypeDescription
idsport_event_timelineStringUnique ID of a match

ex. sr:sport_event:54627247
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 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 FAQ for a complete list of statuses.
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:570927
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. regular_period
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. 1811218561
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. 3rd_game
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, match_info
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