Game Boxscore

⏱️
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. `583eca2f-fb46-11e1-82cb-f4ce4684ea4c`
`name`	`game` - `season`	String	Name of the season ex. `Post-season`
`type`	`game` - `season`	String	Type of the season `PRE` (Preseason), `REG` (Regular Season), `IST` (In-Season Tournament), `PIT` (Play-In Tournament), `PST` (Postseason)
`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
`times_tied`	`game`	Integer	Number of times tied in a game
`bonus`	`team`	Boolean	Signifies a team is in the bonus
`points`	`team`	Integer	Total points for a team
`id`	`team`	GUID	Unique ID of a team ex. `583ec825-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`team`	String	Market name of a team ex. `Golden State`
`name`	`team`	String	Team name ex. `Warriors`
`remaining_timeouts`	`team`	Integer	Remaining timeouts for a team
`reference`	`team`	String	League reference ID of a team ex. `1610612758`
`sr_id`	`team`	GUID	Unique Sportradar ID of a team ex. `sr:team:3426`
`points`	`team` - `scoring` - `quarter`	Integer	Team points in a quarter
`number`	`team` - `scoring` - `quarter`	Integer	Quarter number
`sequence`	`team` - `scoring` - `quarter`	Integer	Period sequence number
`points`	`team` - `scoring` - `overtime`	Integer	Team points in overtime
`number`	`team` - `scoring` - `overtime`	Integer	Overtime number
`sequence`	`team` - `scoring` - `overtime`	Integer	Period sequence number (The first overtime sequence would be `5`)
`home`	`team`	Boolean	Signifies the home team when `true`

Team Leaders

Each Boxscore provides team leaders for: Assists, Points, Rebounds

Attribute	Parent Element	Type	Description
`full_name`	`team` - `leaders` - `assists` / `points` / `rebounds` - `player`	String	Full name of team leader in a statistic ex. `Stephen Curry`
`id`	`player`	GUID	Unique player ID of team leader in a statistic ex. `8ec91366-faea-4196-bbfd-b8fab7434795`
`reference`	`player`	String	League reference ID of a player ex. `1626157`
`sr_id`	`player`	GUID	Unique Sportradar ID of team leader in a statistic ex. `sr:player:608110`

Game

Attribute	Parent Element	Type	Description
`away_team`	`game`	GUID	Unique ID of the away team ex. `583ec825-fb46-11e1-82cb-f4ce4684ea4c`
`home_team`	`game`	GUID	Unique ID of the home team ex. `583ec97e-fb46-11e1-82cb-f4ce4684ea4c`
`entry_mode`	`game`	String	Type of data entry for the game `WEBSOCKET` (Connected to NBA's socket connection), `HTTP` (Connected to NBA's HTTP service), `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`
`inseason_tournament`	`game`	Boolean	Signifies a game is part of the In-Season Tournament
`parent_id`	`game`	GUID	Standard parent ID of a game. Use this ID to group events (like the All-Star game) across seasons ex. `e4986bda-2f75-4228-8295-44b2449088b1`
`quarter`	`game`	Integer	Current quarter of a game
`reference`	`game`	String	League reference ID of a game ex. `1610612758`
`sr_id`	`game`	GUID	Unique Sportradar ID of a game ex. `sr:match:35431817`
`status`	`game`	String	The status of a game `scheduled`, `created`, `inprogress`, `halftime`, `complete`, `closed`, `cancelled`, `delayed`, `postponed`, `time-tbd`, `if-necessary`, `unnecessary` Please see our FAQ for a list of game status definitions
`title`	`game`	String	Game title ex. `Game 6`
`track_on_court`	`game`	Boolean	Signifies a game with tracking of players on the court. When true, we provide a `lineupchange` event type, `on_court` player for Play-by-Play events, and an `on_court` indicator in Game Summary
`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`

Broadcast

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

Team Records

Attribute	Parent Element	Type	Description
`losses`	`team` - `record`	Integer	Number of team losses year-to-date before the game. Record is updated post-game based on the game outcome
`wins`	`team` - `record`	Integer	Number of team wins year-to-date before the game. Record is updated post-game based on the game outcome

Player Statistics (Game)

Note: Player statistics are only provided for the current team leaders in assists, points and rebounds

Attribute	Parent Element	Type	Description
`assists`	`player` - `statistics`	Integer	Number of assists
`assists_turnover_ratio`	`player` - `statistics`	Decimal	Assist to turnover ratio
`blocked_att`	`player` - `statistics`	Integer	Number of blocked attempts
`blocks`	`player` - `statistics`	Integer	Number of shots blocked
`defensive_rebounds`	`player` - `statistics`	Integer	Number of defensive rebounds
`double_double`	`player` - `statistics`	Boolean	Signifies a double-double
`effective_fg_pct`	`player` - `statistics`	Decimal	Effective Field Goal Percentage (FG + 0.5 3P) / FGA*
`efficiency`	`player` - `statistics`	Decimal	Player Efficiency Rating (sPoints + sAssists + sBlocks + sSteals + sFoulsDrawn + sReboundsTotal) - (sTurnovers + sBlocksReceived + sFoulsPersonal + sFoulsTechnical + (sTwoPointersAttempted - sTwoPointersMade) + (sThreePointersAttempted - sThreePointersMade) + (sFreeThrowsAttempted - sFreeThrowsMade))
`efficiency_game_score`	`player` - `statistics`	Decimal	Player Efficiency Game Score sPoints + 0.4 * sFieldGoalsMade - 0.7 * sFieldGoalsAttempted - 0.4 * (sFreeThrowsAttempted - sFreeThrowsMade) + 0.7 * sReboundsOffensive + 0.3 * sReboundsDefensive + sSteals + 0.7 * sAssists + 0.7 * sBlocks - 0.4 * sFoulsPersonal - sTurnovers
`field_goals_att`	`player` - `statistics`	Integer	Number of field goal attempts
`field_goals_made`	`player` - `statistics`	Integer	Number of field goals made
`field_goals_pct`	`player` - `statistics`	Decimal	Field goal percentage ex. `56.5`
`flagrant_fouls`	`player` - `statistics`	Integer	Number of flagrant fouls
`fouls_drawn`	`player` - `statistics`	Integer	Number of fouls drawn
`free_throws_att`	`player` - `statistics`	Integer	Number of free throw attempts
`free_throws_made`	`player` - `statistics`	Integer	Number of free throws made
`free_throws_pct`	`player` - `statistics`	Decimal	Free throw percentage ex. `100.0`
`minutes`	`player` - `statistics`	String	Number of minutes played ex. `40:07`
`offensive_fouls`	`player` - `statistics`	Integer	Number of offensive fouls
`offensive_rebounds`	`player` - `statistics`	Integer	Number of offensive rebounds
`personal_fouls`	`player` - `statistics`	Integer	Number of personal fouls
`pls_min`	`player` - `statistics`	Integer	Plus/Minus (Team scoring while a player is on the court) ex. `-1` or `12`
`points`	`player` - `statistics`	Integer	Number of points
`points_in_paint`	`player` - `statistics`	Integer	Number of points in the paint
`points_in_paint_att`	`player` - `statistics`	Integer	Number of points in the paint attempts
`points_in_paint_made`	`player` - `statistics`	Integer	Number of points in the paint baskets
`points_in_paint_pct`	`player` - `statistics`	Decimal	Points in the paint percentage ex. `28.6`
`points_off_turnovers`	`player` - `statistics`	Integer	Number of points off turnovers
`rebounds`	`player` - `statistics`	Integer	Number of rebounds
`second_chance_pts`	`player` - `statistics`	Integer	Number of second chance points
`steals`	`player` - `statistics`	Integer	Number of steals
`tech_fouls`	`player` - `statistics`	Integer	Number of total unsportsmanlike technical fouls
`tech_fouls_non_unsportsmanlike`	`player` - `statistics`	Integer	Number of non-unsportsmanlike technical fouls
`three_points_att`	`player` - `statistics`	Integer	Number of 3-point attempts
`three_points_made`	`player` - `statistics`	Integer	Number of 3-point baskets
`three_points_pct`	`player` - `statistics`	Decimal	3-point percentage ex. `100.0`
`triple_double`	`player` - `statistics`	Boolean	Signifies a triple-double
`true_shooting_att`	`player` - `statistics`	Decimal	Number of attempts used to determine true shooting percentage sFieldGoalsAttempted + (0.44 * sFreeThrowsAttempted)
`true_shooting_pct`	`player` - `statistics`	Decimal	True Shooting Percentage 100 * sPoints / (2 * sTrueShootingAttempts)
`turnovers`	`player` - `statistics`	Integer	Number of turnovers
`two_points_att`	`player` - `statistics`	Integer	Number of 2-point attempts
`two_points_made`	`player` - `statistics`	Integer	Number of 2-point baskets
`two_points_pct`	`player` - `statistics`	Decimal	2-point percentage ex. `100.0`

Player

Attribute	Parent Element	Type	Description
`full_name`	`player`	String	Full name of a player ex. `Stephen Curry`
`jersey_number`	`player`	Integer	Number of a player's jersey
`id`	`player`	GUID	Unique player ID ex. `8ec91366-faea-4196-bbfd-b8fab7434795`
`position`	`player`	String	Position of a player `NA`, `C`, `C-F`, `F`, `F-C`, `F-G`, `G`, `G-F`
`primary_position`	`player`	String	Primary position of a player `NA`, `C`, `PF`, `PG`, `SF`, `SG`
`reference`	`player`	String	League reference ID of a player ex. `1626157`
`sr_id`	`player`	GUID	Unique Sportradar ID of a player ex. `sr:player:608110`

Team

Attribute	Parent Element	Type	Description
`alias`	`team`	String	Abbreviation of a team ex. `SAC` (Sacramento)
`id`	`team`	GUID	Unique ID of a team ex. `583ed0ac-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`team`	String	Market name of a team ex. `Sacramento`
`name`	`team`	String	Team name ex. `Kings`
`reference`	`team`	String	League reference ID of a team ex. `1610612758`
`sr_id`	`team`	GUID	Unique Sportradar ID of a team ex. `sr:team:3415`