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:51941895
start_timesport_event_timelineDateStart time of a match

ex. 2024-03-26T20:00:00+00:00
Sport Event Status
AttributeParent ElementTypeDescription
aggregate_away_scoresport_event_statusIntegerAggregate score (of multiple sport events) for the away team
aggregate_home_scoresport_event_statusIntegerAggregate score (of multiple sport events) for the home team
aggregate_winner_idsport_event_statusStringUnique ID of the aggregate score winner

ex. sr:competitor:51161
away_scoresport_event_statusIntegerTotal score for the away competitor in a match
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time
home_scoresport_event_statusIntegerTotal score for the home competitor in a match
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time
decided_by_fedsport_event_statusBooleanSignifies a match result was decided by the federation when true. For example, incomplete due to crowd disruption
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, live, ended
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:51161
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. pause
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_half
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
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