Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Game Boxscore

NBA Game Boxscore Top-level team scores by quarter, along with full statistics for each teams’ leaders in points, rebounds, and assists.

⏱️

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:
AttributeParent ElementTypeDescription
idgame - seasonGUIDUnique season ID
ex. 583eca2f-fb46-11e1-82cb-f4ce4684ea4c
namegame - seasonStringName of the season
ex. Post-season
typegame - seasonStringType of the season
PRE (Preseason), REG (Regular Season), IST (In-Season Tournament), PIT (Play-In Tournament), PST (Postseason)
yeargame - seasonIntegerYear of the season
Boxscore:
AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game
ex. 19079
lead_changesgameIntegerNumber of lead changes in a game
times_tiedgameIntegerNumber of times tied in a game
bonusteamBooleanSignifies a team is in the bonus
pointsteamIntegerTotal points for a team
idteamGUIDUnique ID of a team
ex. 583ec825-fb46-11e1-82cb-f4ce4684ea4c
marketteamStringMarket name of a team
ex. Golden State
nameteamStringTeam name
ex. Warriors
remaining_timeoutsteamIntegerRemaining timeouts for a team
referenceteamStringLeague reference ID of a team
ex. 1610612758
sr_idteamGUIDUnique Sportradar ID of a team
ex. sr:team:3426
pointsteam - scoring - quarterIntegerTeam points in a quarter
numberteam - scoring - quarterIntegerQuarter number
sequenceteam - scoring - quarterIntegerPeriod sequence number
pointsteam - scoring - overtimeIntegerTeam points in overtime
numberteam - scoring - overtimeIntegerOvertime number
sequenceteam - scoring - overtimeIntegerPeriod sequence number (The first overtime sequence would be 5)
hometeamBooleanSignifies the home team when true
Team Leaders:

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

AttributeParent ElementTypeDescription
full_nameteam - leaders - assists / points / rebounds - playerStringFull name of team leader in a statistic
ex. Stephen Curry
idplayerGUIDUnique player ID of team leader in a statistic
ex. 8ec91366-faea-4196-bbfd-b8fab7434795
referenceplayerStringLeague reference ID of a player
ex. 1626157
sr_idplayerGUIDUnique 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 conneciton), 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 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. 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:
AttributeParent ElementTypeDescription
channelbroadcastStringName of a game's broadcast channel
ex. 649
localebroadcastStringSignifies the locale of a broadcast
ex. Home, Away, National
networkbroadcastStringName of a game's broadcast network
ex. ESPN
typebroadcastStringType of broadcast
ex. TV
Team Records:
AttributeParent ElementTypeDescription
lossesteam - recordIntegerNumber of team losses year-to-date before the game. Record is updated post-game based on the game outcome
winsteam - recordIntegerNumber 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:
AttributeParent ElementTypeDescription
full_nameplayerStringFull name of a player
ex. Stephen Curry
jersey_numberplayerIntegerNumber of a player's jersey
idplayerGUIDUnique player ID
ex. 8ec91366-faea-4196-bbfd-b8fab7434795
positionplayerStringPosition of a player
NA, C, C-F, F, F-C, F-G, G, G-F
primary_positionplayerStringPrimary position of a player
NA, C, PF, PG, SF, SG
referenceplayerStringLeague reference ID of a player
ex. 1626157
sr_idplayerGUIDUnique Sportradar ID of a player
ex. sr:player:608110
Team:
AttributeParent ElementTypeDescription
aliasteamStringAbbreviation of a team
ex. SAC (Sacramento)
idteamGUIDUnique ID of a team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketteamStringMarket name of a team
ex. Sacramento
nameteamStringTeam name
ex. Kings
referenceteamStringLeague reference ID of a team
ex. 1610612758
sr_idteamGUIDUnique Sportradar ID of a team
ex. sr:team:3415
Language
Credentials
Header
Click Try It! to start a request and see the response here!