get
https://api.sportradar.com/nba//v8//games//boxscore.
NBA Game Boxscore Top-level team scores by quarter, along with full statistics for each teams’ leaders in points, rebounds, and assists.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Update FrequencyTTL / Cache:
- 60 seconds when a game is in
scheduledstatus- 3 seconds when a game moves to
inprogress- 600 seconds when a game moves to
closed- 4 hours when seven days have passed since
closedData Updates: Realtime
Tracking Live GamesLearn 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. 583eca2f-fb46-11e1-82cb-f4ce4684ea4c |
name | game - season | String | Name of the season ex. Post-season |
type | game - season | String | Type of the seasonPRE (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 gameWEBSOCKET (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 clockex. 00:21.70 |
coverage | game | String | Coverage level of a gamefull, 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 gamescheduled, created, inprogress, halftime, complete, closed, cancelled, delayed, postponed, time-tbd, if-necessary, unnecessaryPlease see ourFAQ 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. 2025-10-21T23:30: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. 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
Team win-loss data is added after a game moves to
closedstatus. It is not present prior to or during a game.
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
losses | team - record | Integer | Number of team losses year-to-date after a game |
wins | team - record | Integer | Number of team wins year-to-date after a game |
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 playerNA, C, C-F, F, F-C, F-G, G, G-F |
primary_position | player | String | Primary position of a playerNA, 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 |