Live Timelines

get https://api.sportradar.com/americanfootball/{access_level}/v2/{language_code}/schedules/live/timelines.{format}

Global Football Live Timelines provides a play-by-play event timeline for currently live games.

⏱️
Update Frequency
1s Time To Live / Cache

Data Points

Sport Event Situation:

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Away team period score
`home_score`	`sport_event_status` - `period_scores` - `period_score`	Integer	Home team period score
`number`	`sport_event_status` - `period_scores` - `period_score`	Integer	Period number
`type`	`sport_event_status` - `period_scores` - `period_score`	String	Period type `regular_period`, `overtime`, `1st_quarter`, `2nd_quarter`, `3rd_quarter`, `4th_quarter`, `1st_pause`, `2nd_pause`, `3rd_pause`, `awaiting_overtime`, `interrupted`

Sport Event Status:

Attribute	Parent Element	Type	Description
`away_score`	`sport_event_status`	Integer	Total score for the away team in the game
`away_normaltime_score`	`sport_event_status`	Integer	Score for the away team in normal time
`home_score`	`sport_event_status`	Integer	Total score for the home team in the game
`home_normaltime_score`	`sport_event_status`	Integer	Score for the home team in normal time
`match_status`	`sport_event_status`	String	Status within a match (sport event). Provides more detail on the state of a sport event when live than `status` ex. `not_started`, `1st_quarter`, `ended`, `cancelled` See our FAQ for a complete list of statuses and their definitions.
`status`	`sport_event_status`	String	Status of a sport event ex. `not_started`, `live`, `ended`, `closed` See our FAQ for a complete list of statuses and their definitions.
`winner_id`	`sport_event_status`	String	Unique ID of the match winner ex. `sr:competitor:44`

Game Timeline:

Attribute	Parent Element	Type	Description
`id`	`sport_event_timeline`	String	Unique Id of a sport event ex. `sr:sport_event:46377483`
`start_time`	`sport_event_timeline`	Date-time	Start time of a sport event ex. `2024-04-23T18:15:00+00:00`
`away_score`	`timeline` - `event`	Integer	Score for the away team after a timeline event
`break_name`	`timeline` - `event`	String	Brief description of a break event ex. `1st_pause`
`competitor`	`timeline` - `event`	String	Designation of a competitor for a timeline event `home`, `away`
`home_score`	`timeline` - `event`	Integer	Score for the home team after a timeline event
`id`	`timeline` - `event`	Integer	Unique ID for a timeline event ex. `1844810927`
`match_clock`	`timeline` - `event`	String	Clock value for a timeline event, in minutes and seconds ex. `10:16`
`match_time`	`timeline` - `event`	Integer	Clock value of a timeline event, in minutes ex. `11`
`period`	`timeline` - `event`	Integer	Period (quarter) number of a timeline event
`period_name`	`timeline` - `event`	String	Period name of a timeline event, appearing at the beginning of a period ex. `2nd_quarter`
`time`	`timeline` - `event`	Date-time	Timestamp of a timeline event ex. `2024-04-16T20:49:49+00:00`
`type`	`timeline` - `event`	String	Type of timeline event. Reference enum_event_type in our Global American Football OpenAPI Spec for a complete list of event types ex. `match_started`, `score_change`, `period_score`

Player Event Details:

Attribute	Parent Element	Type	Description
`id`	`timeline` - `event` - `player`	String	Unique ID of a player associated with an event ex. `sr:player:608026`
`name`	`timeline` - `event` - `player`	String	Name of a player associated with an event ex. `Tavares, Edy`
`type`	`timeline` - `event` - `player`	String	Type of event associated with a player ex. `scorer`, `assist`

Language

Authorization

Query

Click Try It! to start a request and see the response here!