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.
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 seasonPRE, 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 |
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 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 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 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:
| 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 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 |