Game Play-by-Play

⏱️
Update Frequency
TTL / Cache: This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.
Data Updates: Realtime

Data Points

Season

Attribute	Parent Element	Type	Description
`id`	`game` - `season`	GUID	Unique season ID ex. `415ae0cb-38dd-4ace-8f22-fb6015b39006`
`name`	`game` - `season`	String	Name of the season ex. `Post-season`
`type`	`game` - `season`	String	Type of the season `PRE`, `REG`, `PIT`, `PST`
`year`	`game` - `season`	Integer	Year of the season

Boxscore

Attribute	Parent Element	Type	Description
`attendance`	`game`	Integer	Attendance of a game ex. `19079`
`lead_changes`	`game`	Integer	Number of lead changes in a game
`possession_arrow`	`game`	GUID	Unique ID of the team with the current possession arrow (available for full coverage games only) ex. `c2104cdc-c83d-40d2-a3cd-df986e29f5d3`
`times_tied`	`game`	Integer	Number of times tied in a game
`lead_changes`	`game` - `half` / `overtime` - `scoring`	Integer	Number of lead changes in a half
`times_tied`	`game` - `half` / `overtime` - `scoring`	Integer	Number of times tied in a half
`id`	`overtime`	GUID	Unique ID of overtime ex. `1c2463d7-43ec-4b83-a29c-d66087d8e8df`
`number`	`overtime`	Integer	Overtime number
`sequence`	`overtime`	Integer	Period sequence number (The first overtime sequence would be `3`)
`half`	`game`	Integer	Half number of the game
`id`	`half`	GUID	Unique ID of a half ex. `47091cc4-08c2-4f83-9d8d-59c3c85e1725`
`number`	`half`	Integer	Half number

Game

Attribute	Parent Element	Type	Description
`alias`	`away`	String	Abbreviation of the away team ex. `TCU`
`id`	`away`	GUID	Unique ID of the away team ex. `583eca88-fb46-11e1-82cb-f4ce4684ea4c`
`away_team`	`game`	GUID	Unique ID of the away team ex. `583eca88-fb46-11e1-82cb-f4ce4684ea4c`
`bonus`	`away`	Boolean	Signifies the away team is in the bonus (available for full coverage games only)
`conference_game`	`game`	Boolean	Signifies an in-Conference matchup when `true` ex. (SEC vs. SEC)
`double_bonus`	`away`	Boolean	Signifies the away team is in the double bonus (available for full coverage games only)
`forfeit_winner`	`away`	Boolean	Signifies the away team won by forfeit when `true`
`name`	`away`	String	Team name of the away team ex. `Horned Frogs`
`rank`	`away`	Integer	Team rank in the AP Top 25. Value represents the team's rank at the time the game was moved to `created` status.
`remaining_timeouts`	`away`	Integer	Remaining timeouts for the away team
`entry_mode`	`game`	String	Type of data entry for the game `LDE` (Live Data Entry by Sportradar)
`clock`	`game`	String	Clock value of the game ex. `12:37`
`clock_decimal`	`game`	String	Clock value in decimal form when the game clock is under 1:00. Otherwise, it displays the same value as `clock` ex. `00:21.70`
`coverage`	`game`	String	Coverage level of a game `full`, `extended_boxscore`
`duration`	`game`	String	Duration of a game ex. `2:26`
`id`	`game`	GUID	Unique ID of a game ex. `1f730a9a-8221-48ff-a259-ac2103fb58b0`
`parent_id`	`game`	GUID	Standard parent ID of a game. Use this ID to group events (like conference tournaments) across seasons ex. `f3c4703e-678c-4338-90dd-116fc5e326c9`
`half`	`game`	Integer	Current half of a game
`status`	`game`	String	The status of a game `scheduled`, `created`, `inprogress`, `halftime`, `complete`, `closed`, `cancelled`, `delayed`, `postponed`, `time-tbd`, `if-necessary`, `unnecessary`, `forfeited` Please see our FAQ section for a list of game status definitions
`title`	`game`	String	Title of a game ex. `Patriot League - Quarterfinal 3`
`alias`	`home`	String	Abbreviation of the home team ex. `TTU` (Texas Tech University)
`id`	`home`	GUID	Unique ID of the home team ex. `f7fcbb6e-4a55-41ea-ba21-f763ed914467`
`home_team`	`game`	GUID	Unique ID of the home team ex. `f7fcbb6e-4a55-41ea-ba21-f763ed914467`
`bonus`	`home`	Boolean	Signifies the home team is in the bonus (available for full coverage games only)
`double_bonus`	`home`	Boolean	Signifies the home team is in the double bonus (available for full coverage games only)
`forfeit_winner`	`home`	Boolean	Signifies the home team won by forfeit when `true`
`name`	`home`	String	Team name of the home team ex. `Red Raiders`
`rank`	`home`	Integer	Team rank in the AP Top 25. Value represents the team's rank at the time the game was moved to `created` status.
`remaining_timeouts`	`home`	Integer	Remaining timeouts for the home team
`neutral_site`	`game`	Boolean	Signifies a game played at a neutral venue
`scheduled`	`game`	dateTime	Scheduled date and time of a game ex. `2024-02-14T05:00:00Z`
`away`	`game` - `time_zones`	String	Time zone of the away team ex. `US/Pacific`
`home`	`game` - `time_zones`	String	Time zone of the home team ex. `US/Eastern`
`venue`	`game` - `time_zones`	String	Time zone of the venue ex. `US/Eastern`
`track_on_court`	`game`	Boolean	Signifies a game with live tracking of players on the court when `true` When `true`, we provide a `lineupchange` event type and an `on_court` element for events in the Game Play-by-Play endpoint, and an `on_court` indicator for each player in the Game Summary endpoint. Click here for more information on in-game player substitutions

Broadcast

Attribute	Parent Element	Type	Description
`channel`	`broadcast`	String	Name of a game's broadcast channel ex. `208`
`locale`	`broadcast`	String	Signifies the locale of a broadcast ex. `Home`, `Away`, `National`
`network`	`broadcast`	String	Name of a game's broadcast network ex. `ESPNU` or `ESPN+`
`type`	`broadcast`	String	Type of broadcast ex. `TV` or `Internet`

Play-by-Play - Attribution & Possession

Attribution is the team associated with the play-by-play event (i.e. the statistic associated with it). Possession is the team who currently has the possession of the ball as a result of that play-by-play event.

Attribute	Parent Element	Type	Description
`id`	`event` - `attribution`	GUID	Unique ID of a team ex. `583ed0ac-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`event` - `attribution`	String	Market name of a team ex. `TCU`
`name`	`event` - `attribution`	String	Team name ex. `Horned Frogs`
`team_basket`	`event` - `attribution`	String	The basket the offensive team is shooting at in the arena. Direction is based on the TV broadcast's perspective. `left`, `right`
`id`	`event` - `possession`	GUID	Unique ID of a team ex. `583ed0ac-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`event` - `possession`	String	Market name of a team ex. `TCU`
`name`	`event` - `possession`	String	Team name ex. `Horned Frogs`
`team_basket`	`event` - `possession`	String	The basket the offensive team is shooting at in the arena. Direction is based on the TV broadcast's perspective. `left`, `right`

Play-by-Play - Home/Away Teams

Attribute	Parent Element	Type	Description
`alias`	`scoring` / `half` - `away`	String	Abbreviation of the away team ex. `TCU`
`bonus`	`scoring` / `half` - `away`	Boolean	Signifies a team is in the bonus
`points`	`game` - `away`	Integer	Total points for the away team
`points`	`half` - `away`	Integer	Points in a half for the away team
`id`	`scoring` / `half` - `away`	GUID	Unique ID of the away team ex. `583ed0ac-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`scoring` / `half` - `away`	String	Market name of the away team ex. `TCU`
`name`	`scoring` / `half` - `away`	String	Away team name ex. `Horned Frogs`
`alias`	`scoring` / `half` - `home`	String	Abbreviation of the home team ex. `TCU`
`bonus`	`scoring` / `half` - `home`	Boolean	Signifies a team is in the bonus
`points`	`game` - `home`	Integer	Total points for the home team
`points`	`half` - `home`	Integer	Points in a half for the home team
`id`	`scoring` / `half` - `home`	GUID	Unique ID of the home team ex. `583ed0ac-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`scoring` / `half` - `home`	String	Market name of the home team ex. `TCU`
`name`	`scoring` / `half` - `home`	String	Home team name ex. `Horned Frogs`

Play-by-Play - Event

Attribute	Parent Element	Type	Description
`attempt`	`event`	String	Text description of a free throw attempt ex. `1 of 2` or `2 of 2`
`away_points`	`event`	Integer	Total points for the away team after an event
`clock`	`event`	String	Clock value of an event ex. `12:37`
`clock_decimal`	`event`	String	Clock value in decimal form when the game clock is under 1:00. Otherwise, it displays the same value as `clock` ex. `00:21.70`
`description`	`event`	String	Text description of an event ex. `Jaylon Tyson makes three point jump shot (Fardaws Aimaq assists)`
`event_type`	`event`	String	Type of event ex. `turnover` or `rebound` See our FAQ for a complete list of types
`free_throw_type`	`event`	String	Type of free throw ex. `regular`, `technical`, `flagrant`, `clear path`
`home_points`	`event`	Integer	Total points for the home team after an event
`id`	`event`	GUID	Unique ID of an event ex. `034aca60-ec33-488f-aa05-b493aff755f7`
`action_area`	`event` - `location`	String	Action area of an event `underbasket`, `inthepaint`, `insiderightwing`, `insideright`, `insidecenter`, `insideleft`, `insideleftwing`, `outsideright`, `outsidecenter`, `outsideleft`, `outsideleftwing`, `backcourt`
`coord_x`	`event` - `location`	Integer	X coordinate of an event. The court we use is 1128 by 600; the scale is in inches.
`coord_y`	`event` - `location`	Integer	Y coordinate of an event. The court we use is 1128 by 600; the scale is in inches.
`number`	`event`	Integer	Sequential number of an event in a game
`sequence`	`event`	Integer	UNIX timestamp of the wall clock value. Use this value to help sequence play-by-play events (smallest to largest sequence number). ex. `1678835426293`
`turnover_type`	`event`	String	Type of turnover ex. `Traveling` or `Lane Violation`
`created`	`event`	dateTime	Timestamp of the creation of an event ex. `2024-02-14T05:00:00Z`
`updated`	`event`	dateTime	Timestamp of the last update to an event ex. `2024-02-14T05:00:00Z`

Play-by-Play - Play Participants & Stats

Attribute	Parent Element	Type	Description
`id`	`event` - `statistics` - `team`	GUID	Unique ID of a team ex. `583ed0ac-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`event` - `statistics` - `team`	String	Market name of a team ex. `TCU`
`name`	`event` - `statistics` - `team`	String	Team name ex. `Horned Frogs`
`full_name`	`event` - `statistics` - `player`	String	Full name of a player ex. `Emanuel Miller`
`id`	`event` - `statistics` - `player`	GUID	Unique player ID ex. `3b1f1b14-b780-4012-850b-e0630abefb4d`
`jersey_number`	`event` - `statistics` - `player`	Integer	Number of a player's jersey
`made`	`event` - `statistics` - `fieldgoal`	Boolean	Signifies a made basket
`points`	`event` - `statistics` - `fieldgoal`	Integer	Number of points scored for an event
`rebound_type`	`event` - `statistics` - `rebound`	String	Rebound type `defensive`, `offensive`
`shot_type`	`event` - `statistics` - `fieldgoal`	String	Shot type `jump shot`, `layup`, `dunk`, `hook`, `tip`
`shot_type_desc`	`event` - `statistics` - `fieldgoal`	String	Text description of a shot type ex. `driving` or `alley-oop` See our FAQ for a complete list of descriptions
`three_point_shot`	`event` - `statistics` - `fieldgoal`	Boolean	Signifies a 3-point attempt
`made`	`event` - `statistics` - `freethrow`	Boolean	Signifies a made free throw
`points`	`event` - `statistics` - `freethrow`	Integer	Number of points scored for a free throw
`free_throw_type`	`event` - `statistics` - `freethrow`	String	Type of free throw ex. `regular`, `technical`, `flagrant`, `clear path`

Play-by-Play - On Court Participants

Attribute	Parent Element	Type	Description
`full_name`	`event` - `on_court` - `player`	String	Full name of a player ex. `Emanuel Miller`
`id`	`event` - `on_court` - `player`	GUID	Unique player ID ex. `3b1f1b14-b780-4012-850b-e0630abefb4d`
`jersey_number`	`event` - `on_court` - `player`	Integer	Number of a player's jersey
`id`	`event` - `on_court` - `home` / `away`	GUID	Unique ID of a team ex. `583ed0ac-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`event` - `on_court` - `home` / `away`	String	Market name of a team ex. `TCU`
`name`	`event` - `on_court` - `home` / `away`	String	Team name ex. `Horned Frogs`

Player

Attribute	Parent Element	Type	Description
`full_name`	`player`	String	Full name of a player ex. `Kris Murray`
`id`	`player`	GUID	Unique ID of a player ex. `0f46d12f-8a60-442f-8c8e-4c350aed6502`
`jersey_number`	`player`	Integer	Number of a player's jersey

Team

Attribute	Parent Element	Type	Description
`id`	`team`	GUID	Unique ID of a team ex. `c10544de-e3bd-4776-ba2e-83df8c017fd1`
`market`	`team`	String	School name of a team ex. `Iowa`
`name`	`team`	String	Team name ex. `Hawkeyes`