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:49877723
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, in_progress, ended

See our FAQ for a complete list of statuses and their definitions.
count_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:120814
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, snooker_session_break
Match Timeline
AttributeParent ElementTypeDescription
away_scoretimeline - eventIntegerAway competitor point score
best_of_framestimeline - eventIntegerProvides the number of frames played for the match

ex. best_of="35"
breaktimeline - eventStringDisplay score for a competitor after a shot

ex. 1:0, 6:0
competitortimeline - eventStringDesignation of a competitor for a timeline event

home, away
frame_numbertimeline - eventIntegerFrame number for a timeline event
frame_scoretimeline - eventStringTotal frame display score after a shot

ex. 22:0, 90:11
home_scoretimeline - eventIntegerHome competitor point score
idtimeline - eventIntegerUnique ID for a timeline event

ex. 1692895333
lowest_value_color_availabletimeline - eventIntegerLowest value ball color available after a shot

ex. 2, 7
number_of_red_ballstimeline - eventIntegerNumber of red balls for a match

ex. 15
period_nametimeline - eventStringPeriod name of a timeline event, appearing at the beginning of a period

ex. snooker_session_break
pointstimeline - eventIntegerNumber of points recorded on a break
red_balls_lefttimeline - eventIntegerNumber of red balls left on the table after a shot

ex. 10
timetimeline - eventDate-timeTimestamp of a timeline event

ex. 2024-04-16T20:49:49+00:00
typetimeline - eventStringType of timeline event

ex. match_info, break_off, match_started, match_ended, period_start, change_of_possession, ball_pot, score_change, foul, free_ball, re_rack, frame_started, frame_ended
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