Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

League Timeline

Soccer Extended League Timeline provides an alternate set of statistics for an event which match official league sites.

Official stats are provided for: England Premier League, Germany Bundesliga, Italy Serie A, Spain La Liga, UEFA Champions League, USA MLS, Austria Bundesliga.p

⏱️

Update Frequency

300s Time To Live / Cache


Data Points

Category & Sport
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a sport event's category

ex. ENG (England)
idsport_event_context - categoryStringUnique category ID for a sport event

ex. sr:category:1
namesport_event_context - categoryStringName for a sport event's category

ex. England (Premier League)
idsport_event_context - sportStringUnique sport ID for a sport event

ex. sr:sport:1
namesport_event_context - sportStringName for a sport event's sport

ex. Soccer
Competition
AttributeParent ElementTypeDescription
alternative_namesport_event_context - competitionStringAlternate name of a competition

ex. English Premier League (instead of Premier League)
gendersport_event_context - competitionStringGender for a competition

ex. men
idsport_event_context - competitionStringUnique ID for a competition

ex. sr:competition:17 (Premier League)
namesport_event_context - competitionStringName of a competition

ex. Premier League
parent_idsport_event_context - competitionStringUnique parent ID for a competition. Typically present for group stage or playoff competitions

ex. sr:competition:945 used to link competitions together, like the World Cup and the various qualifiers.
Group
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group

ex. sr:league:80253 (UEFA Euro 2024, Group D)
namesport_event_context - groups - groupStringName of a sport event's group

ex. UEFA Euro 2024, Group D
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group

ex. D
Round
AttributeParent ElementTypeDescription
competition_sport_event_numbersport_event_context - roundIntegerSport event number within a competition. Used for competitions that have fixed match numbers (World Cup)
cup_round_idsport_event_context - roundStringUnique ID for a sport event's cup round

ex. sr:cup_round:1988995
cup_round_number_of_sport_eventssport_event_context - roundIntegerNumber of events in a sport event's round
cup_round_sport_event_numbersport_event_context - roundIntegerNumber within the cup_round of a match ID. For example, 1st leg of 2
namesport_event_context - roundStringName of a sport event's round

ex. round_3 or round_of_16
numbersport_event_context - roundIntegerNumber of a sport event's round
other_sport_event_idsport_event_context - roundStringA linked sport event ID, typically in a two-legged tie

ex. sr:sport_event:47395897
Season
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a sport event belongs to

ex. sr:competition:17 (Premier League)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a sport event's season

ex. 2024-05-19
idsport_event_context - seasonStringUnique ID for a sport event's season

ex. sr:season:105353 (Premier League 23/24)
namesport_event_context - seasonStringName of a sport event's season

ex. Premier League 23/24
start_datesport_event_context - seasonDateStart date of a sport event's season

ex. 2023-08-11
yearsport_event_context - seasonStringYear of a sport event's season

ex. 23/24
Stage
AttributeParent ElementTypeDescription
end_datesport_event_context - stageDateEnd date of a sport event's stage

ex. 2024-05-19
ordersport_event_context - stageIntegerOrder of a stage within a season
phasesport_event_context - stageStringName of a sport event's stage

ex. regular season, preliminary_round, qualification
start_datesport_event_context - stageDateStart date of a sport event's stage

ex. 2023-08-11
typesport_event_context - stageStringType of a sport event's stage

cup, league
yearsport_event_context - stageStringYear of a sport event's stage

ex. 23/24
Competitor
AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name

ex. LIV (Liverpool FC)
age_groupcompetitors - competitorStringAge group of a competitor, when applicable

ex. U23
countrycompetitors - competitorStringCountry of a competitor

ex. England
country_codecompetitors - competitorStringCountry code of a competitor

ex. ENG (England)
gendercompetitors - competitorStringGender for a competitor

male, female
idcompetitors - competitorStringUnique ID for a competitor

ex. sr:competitor:44 (Liverpool FC)
namecompetitors - competitorStringName for a competitor

ex. Liverpool FC
qualifiercompetitors - competitorStringDesignation of a competitor for a sport event

home, away
virtualcompetitors - competitorBooleanSignifies a competitor is a virtual team whan true. Used for placeholder teams in TBD vs TBD matchups.
Player
AttributeParent ElementTypeDescription
idstatistics - competitor - playerStringUnique ID of a player

ex. sr:player:159665
namestatistics - competitor - playerStringName of a player

ex. Salah, Mohamed
starterstatistics - competitor - playerBooleanSignifies a player is in the starting lineup for a sport event when true
Sport Event
AttributeParent ElementTypeDescription
countsport_event_conditions - attendanceIntegerAttendance for a sport event

ex. 25078
neutralsport_event_conditions - groundBooleanSignifies a neutral ground sport event when true
confirmedsport_event_conditions - lineupsBooleanSignifies lineups for a sport event have been confirmed when true
idsport_eventStringUnique ID of a sport event

ex. sr:sport_event:47395897
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date

ex. sr:sport_event:47395897
resume_timesport_eventDateAn updated timestamp if there is a delay at the start or interruption during a match

ex. 2024-03-26T20:00:00+00:00
start_timesport_eventDateStart time of a sport event

ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a sport event is confirmed when true
overall_conditionssport_event_conditions - weatherStringWeather conditions for a sport event

good, medium, bad, indoor, extreme
pitch_conditionssport_event_conditions - weatherStringPitch conditions for a sport event

good, medium, bad
Sport Event - Channel
AttributeParent ElementTypeDescription
countrysport_event - channels - channelStringCountry of a broadcast channel

ex. United States
country_codesport_event - channels - channelStringCountry code of a broadcast channel

ex. USA
namesport_event - channels - channelStringName of a broadcast channel

ex. Fox Soccer Plus
urlsport_event - channels - channelStringURL of a broadcast channel
Sport Event - Referee
AttributeParent ElementTypeDescription
idsport_event_conditions - referees - refereeStringUnique ID for a referee

ex. sr:referee:229470
namesport_event_conditions - referees - refereeStringName of a referee

ex. Brooks, John
nationalitysport_event_conditions - referees - refereeStringNationality of a referee

ex. England
country_codesport_event_conditions - referees - refereeStringCountry code of a referee

ex. ENG
typesport_event_conditions - referees - refereeStringType of a referee

ex. first_assistant_referee, second_assistant_referee, fourth_official, video_assistant_referee, first_additional_assistant, second_additional_assistant, main_referee
Sport Event - Coverage Properties
AttributeParent ElementTypeDescription
typesport_event - coverageStringType of coverage

sport_event, group, competition
ballspottingsport_event - coverage - sport_event_propertiesBooleanSignifies ballspotting is available for a sport event when true
basic_play_by_playsport_event - coverage - sport_event_propertiesBooleanSignifies basic play-by-play is available for a sport event when true
basic_player_statssport_event - coverage - sport_event_propertiesBooleanSignifies basic player stats is available for a sport event when true
basic_team_statssport_event - coverage - sport_event_propertiesBooleanSignifies basic team stats is available for a sport event when true
commentarysport_event - coverage - sport_event_propertiesBooleanSignifies commentary is available for a sport event when true
deeper_play_by_playsport_event - coverage - sport_event_propertiesBooleanSignifies deeper play-by-play is available for a sport event when true
deeper_player_statssport_event - coverage - sport_event_propertiesBooleanSignifies deeper player stats is available for a sport event when true
deeper_team_statssport_event - coverage - sport_event_propertiesBooleanSignifies deeper team stats is available for a sport event when true
extended_play_by_playsport_event - coverage - sport_event_propertiesBooleanSignifies extended play-by-play data is available for a sport event when true. Access this data in the Sport Event Extended Timeline endpoint.
extended_player_statssport_event - coverage - sport_event_propertiesBooleanSignifies extended player stats is available for a sport event when true
extended_team_statssport_event - coverage - sport_event_propertiesBooleanSignifies extended team stats is available for a sport event when true
formationssport_event - coverage - sport_event_propertiesBooleanSignifies team formations are available for a sport event when true
fun_factssport_event - coverage - sport_event_propertiesBooleanSignifies fun facts are available for a sport event when true
game_clocksport_event - coverage - sport_event_propertiesBooleanSignifies the game clock is available for a sport event when true
goal_scorerssport_event - coverage - sport_event_propertiesBooleanSignifies goal scorers are available for a sport event when true
goal_scorers_livesport_event - coverage - sport_event_propertiesBooleanSignifies goal scorers are available live for a sport event when true
lineupssport_event - coverage - sport_event_propertiesBooleanSignifies goal lineups are available for a sport event when true
lineups_availabilitysport_event - coverage - sport_event_propertiesStringDescribes the availability of lineups as pre-match or post-match

pre, post
probabilitiessport_event - coverage - sport_event_propertiesBooleanSignifies probabilities are available for a sport event when true
scoressport_event - coverage - sport_event_propertiesStringDescribes the availability of scores as live or post-match

live, post
venuesport_event - coverage - sport_event_propertiesBooleanSignifies venue info is available for a sport event when true
Sport Event Situation
AttributeParent ElementTypeDescription
playedsport_event_status - clockStringMatch clock time in minutes

90:00
stoppage_time_playedsport_event_status - clockStringStoppage time played in minutes

5:49
stoppage_time_announcedsport_event_status - clockStringStoppage time announced in minutes

5:00
statussport_event_status - match_situationStringCurrent situtation status of a match

safe, dangerous, attack
qualifiersport_event_status - match_situationStringDefines the team in the current situation status

home, away
updated_atsport_event_status - match_situationDate-TimeTimestamp of the most recent match situation update

ex. 2024-04-14T14:57:28+00:00
away_scoresport_event_status - period_scores - period_scoreIntegerAway team period score
home_scoresport_event_status - period_scores - period_scoreIntegerHome team period score
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod type

regular_period, overtime, penalties, pause, awaiting_extra, extra_time_halftime, interrupted
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:44
away_normaltime_scoresport_event_statusIntegerScore for the away team in normal time
away_overtime_scoresport_event_statusIntegerScore for the away team in overtime
away_scoresport_event_statusIntegerTotal score for the away team in the match
home_normaltime_scoresport_event_statusIntegerScore for the home team in normal time
home_overtime_scoresport_event_statusIntegerScore for the home team in overtime
home_scoresport_event_statusIntegerTotal score for the home team in the match
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. Provides more detail on the state of a match when live than status

ex. not_started, 2nd_half, ended, awaiting_penalties

See our FAQ for a complete list of statuses and their definitions.
match_tiesport_event_statusBooleanSignifies a match ended in a tie when true
scout_abandonedsport_event_statusBooleanSignifies a match was abandoned by a scout when true
statussport_event_statusStringStatus of a match

ex. not_started, live, ended, awaiting_penalties

See our FAQ for a complete list of statuses and their definitions.
winner_idsport_event_statusStringUnique ID of the match winner

ex. sr:competitor:44
Ball Location

Visit our FAQ for additional information on ball location data.

AttributeParent ElementTypeDescription
ordersport_event_status - ball_locations - ball_locationIntegerSequential order of a ball location event. The most recent location is 4 and the oldest location is 1.
qualifiersport_event_status - ball_locations - ball_locationStringDesignation of a competitor for a ball location entry

home, away
xsport_event_status - ball_locations - ball_locationStringHorizontal X coordinate of the pitch. x is a number between 0 and 100. The reference point 0 is at the home team’s goal.
ysport_event_status - ball_locations - ball_locationStringVertical Y coordinate of the pitch. y is a number between 0 and 100. The reference point 0 is on the top of the pitch where the home team’s goal is on the left hand side.
Match Timeline
AttributeParent ElementTypeDescription
away_scoreleague_timeline - eventIntegerScore for the away team after a timeline event
break_nameleague_timeline - eventStringBrief description of a break event

ex. pause
card_descriptoinleague_timeline - eventStringDescription of the scenario during a card event

ex. pre_match, half_time, post_match, player_on_bench, first_half, second_half, during_penalty_shootout
textleague_timeline - event - commentaryStringDescription of the scenario during a card event

Commentary text description of a timeline event

ex. Mario Hermoso (Atletico) has received a yellow card from Slavko Vincic. or It's a goal kick for the home team in Dortmund.
competitorleague_timeline - eventStringDesignation of a competitor for a timeline event

home, away
descriptionleague_timeline - eventStringDescription of an event.

This data point is not currently in use
home_scoreleague_timeline - eventIntegerScore for the home team after a timeline event
idleague_timeline - eventIntegerUnique ID for a timeline event

ex. 1721786685
injury_time_announcedleague_timeline - eventIntegerAmount of injury time announced in minutes
match_clockleague_timeline - eventStringMatch clock value for a timeline event, in minutes and seconds

ex. 89:37
match_timeleague_timeline - eventIntegerMatch clock value of a timeline event, in minutes

ex. 89
methodleague_timeline - eventStringMethod of a scored goal

penalty, own_goal, header, shot, free_kick
outcomeleague_timeline - eventStringOutcome of a missed goal

miss, post, bar
periodleague_timeline - eventIntegerPeriod number of a timeline event
period_nameleague_timeline - eventStringPeriod name of a timeline event, appearing at the beginning of a period

ex. regular_period
period_typeleague_timeline - eventStringPeriod type of a timeline event

regular_period, overtime, penalties, pause, awaiting_extra, extra_time_halftime, interrupted
shootout_away_scoreleague_timeline - eventIntegerAway team shootout score after a timeline event
shootout_home_scoreleague_timeline - eventIntegerHome team shootout score after a timeline event
statusleague_timeline - eventStringStatus available during penalty shootouts (period_type="penalties")

ex. missed, scored, not_taken_yet
stoppage_timeleague_timeline - eventIntegerStoppage time value for a timeline event

ex. 3
stoppage_time_clockleague_timeline - eventStringStoppage time clock value for a timeline event

ex. 2:03
typeleague_timeline - eventStringType of timeline event. See our FAQ for a complete list of event types

ex. goal_kick, period_start, yellow_card
timeleague_timeline - eventDate-timeTimestamp of a timeline event

ex. 2024-04-16T20:49:49+00:00
xleague_timeline - eventIntegerHorizontal X coordinate of a timeline event. x is a number between 0 and 100. The reference point 0 is at the home team’s goal.
yleague_timeline - eventIntegerVertical Y coordinate of a timeline event. y is a number between 0 and 100. The reference point 0 is on the top of the pitch where the home team’s goal is on the left hand side.
Player Event Details
AttributeParent ElementTypeDescription
idevent - playerStringUnique player Id associated with a timeline event

ex. sr:player:2367105
nameevent - playerStringPlayer name associated with a timeline event

ex. Luna, Diego
typeevent - playerStringPlayer activity type associated with a timeline event. Signifies if a player scored a goal, recorded an assist, or participated in a substitution.

ex. scorer, assist, substituted_in, substituted_out
Match Stats (Player)
AttributeParent ElementTypeDescription
assistsplayer - statisticsIntegerPlayer assists for a match
corner_kicksplayer - statisticsIntegerPlayer corner kicks for a match
goalsplayer - statisticsIntegerPlayer goals scored for a match
offsidesplayer - statisticsIntegerPlayer offsides for a match
own_goalsplayer - statisticsIntegerPlayer own goals for a match
red_cardsplayer - statisticsIntegerPlayer red cards for a match
substituted_inplayer - statisticsIntegerSignifies a player was substituted in during a match when 1
substituted_outplayer - statisticsIntegerSignifies a player was substituted out during a match when 1
yellow_cardsplayer - statisticsIntegerPlayer yellow cards for a match
yellow_red_cardsplayer - statisticsIntegerPlayer red cards for a match resulting from two yellow cards
Match Stats (Team)
AttributeParent ElementTypeDescription
assistscompetitor - statisticsIntegerTotal team assists for a match
corner_kickscompetitor - statisticsIntegerTotal team corner kicks for a match
goalscompetitor - statisticsIntegerTeam goals for a match
red_cardscompetitor - statisticsIntegerTotal team red cards for a match
shots_on_goalcompetitor - statisticsIntegerTotal team shots on goal for a match
substitutionscompetitor - statisticsIntegerTotal number player subsitutions in a match
yellow_cardscompetitor - statisticsIntegerTotal team yellow cards for a match
yellow_red_cardscompetitor - statisticsIntegerTotal team red cards for a match which resulted from two yellow cards
Venue
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a venue

ex. 60000
changedvenueBooleanSignifies a venue has been changed when true
city_namevenueStringCity name of a venue

ex. Liverpool
country_codevenueStringCountry code of a venue

ex. ENG (England)
country_namevenueStringCountry name of a venue

ex. England
idvenueStringUnique ID of a venue

ex. sr:venue:579
map_coordinatesvenueStringCoordinates of a venue

ex. 53.430622,-2.960919
namevenueStringName of a venue

ex. Anfield
reduced_capacityvenueBooleanOptional attribute signifying a venue has a restricted capacity when true
reduced_capacity_maxvenueIntegerValue of a venue's restricted capacity
timezonevenueStringTimezone of a venue

ex. Europe/London
Language
Credentials
Header
Click Try It! to start a request and see the response here!