Game Boxscore

Time	Status	User Agent
Retrieving recent requests…

⏱️
Update Frequency
TTL / Cache:

1 minute when a game is in scheduled status

2 seconds when a game moves to inprogress

10 minutes when a game moves to closed

4 hours when seven days have passed since closed

Data Updates: Realtime
Recommended Pull (Non-Live): As needed; the feed can be ignored until 10 minutes before the scheduled start, with the daily change log capturing post-game changes
Recommended Pull (Live): As fast as the response TTL allows while a game is live; begin requesting 10 minutes before the scheduled start

📘
Tracking Live Games
Learn how to use the Game Boxscore for live scoring updates, team scores by quarter, and team leaders in our Live Game Updates integration scenario.

Data Points

Season

Attribute	Parent Element	Type	Description
`id`	`game` - `season`	GUID	Unique season ID ex. `2a29bf58-7069-4ca4-8933-0347544e243d`
`name`	`game` - `season`	String	Name of the season ex. `Post-season`
`type`	`game` - `season`	String	Type of the season `PRE`, `REG`, `SC`, `SCC`, `PST`, `EX`
`year`	`game` - `season`	Integer	Year of the season

Boxscore

Attribute	Parent Element	Type	Description
`attendance`	`game`	Integer	Attendance of a game ex. `966`
`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. `67a79348-041a-45f6-bb12-722d38dc8dbf`
`market`	`team`	String	Market name of a team ex. `Delaware`
`name`	`team`	String	Team name ex. `Blue Coats`
`remaining_timeouts`	`team`	Integer	Remaining timeouts for a team
`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. `Louis King`
`id`	`player`	GUID	Unique player ID of team leader in a statistic ex. `095862fd-28c4-4d93-9e45-b09dbe3384a4`

Game

Attribute	Parent Element	Type	Description
`away_team`	`game`	GUID	Unique ID of the away team ex. `67a79348-041a-45f6-bb12-722d38dc8dbf`
`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. `047ae12b-fd65-41a8-8945-3f4f1305fb9d`
`parent_id`	`game`	GUID	Standard parent ID of a game. Use this ID to group events 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. `2022200406`
`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 section 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. `2022-09-25T20:10:00+00:00`
`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. `216`
`locale`	`broadcast`	String	Signifies the locale of a broadcast ex. `Home`, `Away`, `National`
`network`	`broadcast`	String	Name of a game's broadcast network ex. `NBA TV`
`type`	`broadcast`	String	Type of broadcast ex. `TV` or `Internet`

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. `Anthony Tarke`
`id`	`player`	GUID	Unique player ID ex. `89c7cd33-6143-48dd-82c4-ccbfed25ddaa`
`jersey_number`	`player`	String	Number of a player's jersey
`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`

Team

Attribute	Parent Element	Type	Description
`alias`	`team`	String	Abbreviation of a team ex. `DEl` (Delaware)
`id`	`team`	GUID	Unique ID of a team ex. `67a79348-041a-45f6-bb12-722d38dc8dbf`
`market`	`team`	String	Market name of a team ex. `Delaware`
`name`	`team`	String	Team name ex. `Blue Coats`

Update Frequency

Tracking Live Games

Data Points

200200