NBA Game Summary Top-level boxscore information, along with detailed game stats at the team and player levels.
Update FrequencyTTL / 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 (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. 1610612750 |
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 |
Officials:
Attribute | Parent Element | Type | Description |
---|---|---|---|
assignment | official | String | Official assignment ex. Head Official or Official |
experience | official | String | Number of years officiated in the NBA |
first_name | official | String | First name of an official ex. Dedric |
full_name | official | String | Full name of an official ex. Dedric Taylor |
id | official | GUID | Unique ID of an official ex. 04113d69-1c6f-49b5-b1e4-dfc9b2fd2ec7 |
last_name | official | String | Last name of an official ex. Taylor |
number | official | Integer | Jersey number of an official |
Starters & Activity:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| Boolean | Signifies a player has been deemed part of the 13-player active roster for a game when |
|
| Boolean | Signifies a player is ejected from a game when |
|
| Boolean | Signifies a player has fouled out of a game when |
|
| String | Text description of a "Not Playing" player |
|
| String | Text description of a "Not Playing" reason |
|
| Boolean | Signifies a player is currently on the court when |
|
| Boolean | Signifies a player played in a game when |
|
| Boolean | Signifies a player started a game when |
Game:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| GUID | Unique ID of the away team |
|
| GUID | Unique ID of the home team |
|
| String | Type of data entry for the game |
|
| String | Clock value of the game |
|
| String | Clock value in decimal form when the game clock is under 1:00. Otherwise it displays the same value as |
|
| String | Coverage level of a game |
|
| String | Duration of a game |
|
| GUID | Unique ID of a game |
|
| Boolean | Signifies a game is part of the In-Season Tournament |
|
| GUID | Standard parent ID of a game. Use this ID to group events (like the All-Star game) across seasons |
|
| Integer | Current quarter of a game |
|
| String | League reference ID of a game |
|
| GUID | Unique Sportradar ID of a game |
|
| String | The status of a game |
|
| String | Game title |
|
| Boolean | Signifies a game with tracking of players on the court. |
|
| Boolean | Signifies a game played at a neutral venue |
|
| dateTime | Scheduled date and time of a game |
|
| String | Time zone of the away team |
|
| String | Time zone of the home team |
|
| String | Time zone of the venue |
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):
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| Integer | Number of assists |
|
| Decimal | Assist to turnover ratio |
|
| Integer | Number of blocked attempts |
|
| Integer | Number of shots blocked |
|
| Integer | Number of coach ejections |
|
| Integer | Number of coach technical fouls |
|
| Decimal | Defensive Rating |
|
| Integer | Number of defensive rebounds |
|
| Decimal | Defensive rebound percentage |
|
| Boolean | Signifies a double-double |
|
| Decimal | Effective Field Goal Percentage |
|
| Decimal | Player Efficiency Rating |
|
| Decimal | Player Efficiency Game Score |
|
| Integer | Number of fast break attempts |
|
| Integer | Number of fast break baskets |
|
| Decimal | Fast break percentage |
|
| Integer | Number of fast break points |
|
| Integer | Number of field goal attempts |
|
| Integer | Number of field goals made |
|
| Decimal | Field goal percentage |
|
| Integer | Number of flagrant fouls |
|
| Boolean | Signifies a fouled out player |
|
| Integer | Number of fouls drawn |
|
| Integer | Number of free throw attempts |
|
| Integer | Number of free throws made |
|
| Decimal | Free throw percentage |
|
| Integer | Number of team points against while a player is on the court |
|
| String | Number of minutes played |
|
| Integer | Number of offensive fouls |
|
| Decimal | Offensive Rating |
|
| Integer | Number of offensive rebounds |
|
| Decimal | Offensive rebound percentage |
|
| Integer | Number of personal fouls |
|
| Integer | Number of team points scored while a player is on the court |
|
| Integer | Plus/Minus (Team scoring while a player is on the court) |
|
| Integer | Number of points |
|
| Integer | Number of points in the paint |
|
| Integer | Number of points in the paint attempts |
|
| Integer | Number of points in the paint baskets |
|
| Decimal | Points in the paint percentage |
|
| Integer | Number of points off turnovers |
|
| Integer | Number of rebounds |
|
| Decimal | Rebound percentage |
|
| Integer | Number of second chance attempts |
|
| Integer | Number of second chance baskets |
|
| Decimal | Second chance percentage |
|
| Integer | Number of second chance points |
|
| Integer | Number of steals |
|
| Decimal | Steal percentage |
|
| Integer | Number of total unsportsmanlike technical fouls |
|
| Integer | Number of non-unsportsmanlike technical fouls |
|
| Integer | Number of 3-point attempts |
|
| Integer | Number of 3-point baskets |
|
| Decimal | 3-point percentage |
|
| Boolean | Signifies a triple-double |
|
| Decimal | Number of attempts used to determine true shooting percentage |
|
| Decimal | True Shooting Percentage |
|
| Integer | Number of turnovers |
|
| Decimal | Turnover Percentage |
|
| Integer | Number of 2-point attempts |
|
| Integer | Number of 2-point baskets |
|
| Decimal | 2-point percentage |
Player Statistics by Period (Game):
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| GUID | Unique ID of a period |
|
| Integer | Period number |
|
| Integer | Period sequence number |
|
| String | Type of a period |
|
| Integer | Number of assists |
|
| Decimal | Assist to turnover ratio |
|
| Integer | Number of blocked attempts |
|
| Integer | Number of shots blocked |
|
| Integer | Number of coach ejections |
|
| Integer | Number of coach technical fouls |
|
| Decimal | Defensive Rating |
|
| Integer | Number of defensive rebounds |
|
| Decimal | Defensive rebound percentage |
|
| Boolean | Signifies a double-double |
|
| Decimal | Effective Field Goal Percentage |
|
| Decimal | Player Efficiency Rating |
|
| Decimal | Player Efficiency Game Score |
|
| Integer | Number of fast break attempts |
|
| Integer | Number of fast break baskets |
|
| Decimal | Fast break percentage |
|
| Integer | Number of fast break points |
|
| Integer | Number of field goal attempts |
|
| Integer | Number of field goals made |
|
| Decimal | Field goal percentage |
|
| Integer | Number of flagrant fouls |
|
| Boolean | Signifies a fouled out player |
|
| Integer | Number of fouls drawn |
|
| Integer | Number of free throw attempts |
|
| Integer | Number of free throws made |
|
| Decimal | Free throw percentage |
|
| Integer | Number of team points against while a player is on the court |
|
| String | Number of minutes played |
|
| Integer | Number of offensive fouls |
|
| Decimal | Offensive Rating |
|
| Integer | Number of offensive rebounds |
|
| Decimal | Offensive rebound percentage |
|
| Integer | Number of personal fouls |
|
| Integer | Number of team points scored while a player is on the court |
|
| Integer | Plus/Minus (Team scoring while a player is on the court) |
|
| Integer | Number of points |
|
| Integer | Number of points in the paint |
|
| Integer | Number of points in the paint attempts |
|
| Integer | Number of points in the paint baskets |
|
| Decimal | Points in the paint percentage |
|
| Integer | Number of points off turnovers |
|
| Integer | Number of rebounds |
|
| Decimal | Rebound percentage |
|
| Integer | Number of second chance attempts |
|
| Integer | Number of second chance baskets |
|
| Decimal | Second chance percentage |
|
| Integer | Number of second chance points |
|
| Integer | Number of steals |
|
| Decimal | Steal percentage |
|
| Integer | Number of total unsportsmanlike technical fouls |
|
| Integer | Number of non-unsportsmanlike technical fouls |
|
| Integer | Number of 3-point attempts |
|
| Integer | Number of 3-point baskets |
|
| Decimal | 3-point percentage |
|
| Boolean | Signifies a triple-double |
|
| Decimal | Number of attempts used to determine true shooting percentage |
|
| Decimal | True Shooting Percentage |
|
| Integer | Number of turnovers |
|
| Decimal | Turnover Percentage |
|
| Integer | Number of 2-point attempts |
|
| Integer | Number of 2-point baskets |
|
| Decimal | 2-point percentage |
Team Statistics (Game):
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| Integer | Number of assists |
|
| Decimal | Assist to turnover ratio |
|
| Integer | Number of bench points |
|
| Integer | Largest lead in points for a team |
|
| Integer | Number of blocked attempts |
|
| Integer | Number of shots blocked |
|
| Integer | Number of coach ejections |
|
| Integer | Number of coach technical fouls |
|
| Integer | Average defensive points per position |
|
| Decimal | Defensive Rating |
|
| Integer | Number of defensive rebounds |
|
| Decimal | Effective Field Goal Percentage |
|
| Decimal | Player Efficiency Rating |
|
| Decimal | Player Efficiency Game Score |
|
| Integer | Number of ejections |
|
| Integer | Number of fast break attempts |
|
| Integer | Number of fast break baskets |
|
| Decimal | Fast break percentage |
|
| Integer | Number of fast break points |
|
| Integer | Number of field goal attempts |
|
| Integer | Number of field goals made |
|
| Decimal | Field goal percentage |
|
| Integer | Number of mid-range field goal attempts |
|
| Integer | Number of mid-range field goals made |
|
| Decimal | Mid-range field goal percentage |
|
| Integer | Number of field goal attempts at the rim |
|
| Integer | Number of field goals made at the rim |
|
| Decimal | At the rim field goal percentage |
|
| Integer | Number of flagrant fouls |
|
| Integer | Number of fouled out players |
|
| Integer | Number of fouls drawn |
|
| Integer | Number of free throw attempts |
|
| Integer | Number of free throws made |
|
| Decimal | Free throw percentage |
|
| String | Number of minutes played |
|
| Integer | Opponents score when a team's largest scoring run was attained |
|
| Integer | Team's score when its largest score run was attained |
|
| Integer | Longest streak of unanswered points |
|
| Integer | Number of offensive fouls |
|
| Integer | Average offensive points per position |
|
| Decimal | Offensive Rating |
|
| Integer | Number of offensive rebounds |
|
| Decimal | Number of opponent's possessions based on the |
|
| Integer | Number of personal fouls |
|
| Integer | Total number of rebounds attributed to players |
|
| Integer | Number of player technical fouls |
|
| Integer | Number of turnovers attributed to players |
|
| Integer | Plus/Minus |
|
| Integer | Number of points |
|
| Integer | Number of points against |
|
| Integer | Number of points in the paint |
|
| Integer | Number of points in the paint attempts |
|
| Integer | Number of points in the paint baskets |
|
| Decimal | Points in the paint percentage |
|
| Integer | Number of points off turnovers |
|
| Decimal | Team possessions |
|
| Integer | Number of second chance attempts |
|
| Integer | Number of second chance baskets |
|
| Decimal | Second chance percentage |
|
| Integer | Number of second chance points |
|
| Integer | Number of steals |
|
| Integer | Number of team defensive rebounds |
|
| Integer | Number of team fouls |
|
| Integer | Number of team offensive rebounds |
|
| Integer | Number of team rebounds |
|
| Integer | Number of team technical fouls |
|
| Integer | Sum of team turnovers |
|
| Integer | Number of other technical fouls |
|
| Integer | Number of 3-point attempts |
|
| Integer | Number of 3-point baskets |
|
| Decimal | 3-point percentage |
|
| String | Time leading in a game for a team |
|
| Integer | Number of total fouls (team fouls + |
|
| Integer | Number of total rebounds ( |
|
| Integer | Number of total team turnovers ( |
|
| Decimal | Number of attempts used to determine true shooting percentage |
|
| Decimal | True Shooting Percentage |
|
| Integer | Sum of player turnovers |
|
| Integer | Number of 2-point attempts |
|
| Integer | Number of 2-point baskets |
|
| Decimal | 2-point percentage |
Team Statistics by Period (Game):
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| GUID | Unique ID of a period |
|
| Integer | Period number |
|
| Integer | Period sequence number |
|
| String | Type of a period |
|
| Integer | Number of assists |
|
| Decimal | Assist to turnover ratio |
|
| Integer | Number of bench points |
|
| Integer | Largest lead in points for a team |
|
| Integer | Number of blocked attempts |
|
| Integer | Number of shots blocked |
|
| Integer | Number of coach ejections |
|
| Integer | Number of coach technical fouls |
|
| Integer | Average defensive points per position |
|
| Decimal | Defensive Rating |
|
| Integer | Number of defensive rebounds |
|
| Decimal | Effective Field Goal Percentage |
|
| Decimal | Player Efficiency Rating |
|
| Decimal | Player Efficiency Game Score |
|
| Integer | Number of ejections |
|
| Integer | Number of fast break attempts |
|
| Integer | Number of fast break baskets |
|
| Decimal | Fast break percentage |
|
| Integer | Number of fast break points |
|
| Integer | Number of field goal attempts |
|
| Integer | Number of field goals made |
|
| Decimal | Field goal percentage |
|
| Integer | Number of flagrant fouls |
|
| Integer | Number of fouled out players |
|
| Integer | Number of fouls drawn |
|
| Integer | Number of free throw attempts |
|
| Integer | Number of free throws made |
|
| Decimal | Free throw percentage |
|
| String | Number of minutes played |
|
| Integer | Number of offensive fouls |
|
| Integer | Average offensive points per position |
|
| Decimal | Offensive Rating |
|
| Integer | Number of offensive rebounds |
|
| Decimal | Number of opponent's possessions based on the |
|
| Integer | Number of personal fouls |
|
| Integer | Number of player technical fouls |
|
| Integer | Plus/Minus |
|
| Integer | Number of points |
|
| Integer | Number of points against |
|
| Integer | Number of points in the paint |
|
| Integer | Number of points in the paint attempts |
|
| Integer | Number of points in the paint baskets |
|
| Decimal | Points in the paint percentage |
|
| Integer | Number of points off turnovers |
|
| Decimal | Team possessions |
|
| Integer | Number of rebounds |
|
| Integer | Number of second chance attempts |
|
| Integer | Number of second chance baskets |
|
| Decimal | Second chance percentage |
|
| Integer | Number of second chance points |
|
| Integer | Number of steals |
|
| Integer | Number of team defensive rebounds |
|
| Integer | Number of team fouls |
|
| Integer | Number of team offensive rebounds |
|
| Integer | Number of team rebounds |
|
| Integer | Number of team technical fouls |
|
| Integer | Sum of team turnovers |
|
| Integer | Number of other technical fouls |
|
| Integer | Number of 3-point attempts |
|
| Integer | Number of 3-point baskets |
|
| Decimal | 3-point percentage |
|
| String | Time leading in a game for a team |
|
| Integer | Number of total fouls (team fouls + |
|
| Integer | Number of total rebounds ( |
|
| Integer | Number of total team turnovers ( |
|
| Decimal | Number of attempts used to determine true shooting percentage |
|
| Decimal | True Shooting Percentage |
|
| Integer | Number of turnovers |
|
| Integer | Number of 2-point attempts |
|
| Integer | Number of 2-point baskets |
|
| Decimal | 2-point percentage |
Player:
Attribute | Parent Element | Type | Description |
---|---|---|---|
first_name | player | String | First name of a player ex. Stephen |
full_name | player | String | Full name of a player ex. Stephen Curry |
id | player | GUID | Unique player ID ex. 8ec91366-faea-4196-bbfd-b8fab7434795 |
jersey_number | player | Integer | Number of a player's jersey |
last_name | player | String | Last name of a player ex. Curry |
name_suffix | player | String | Suffix of a player ex. Jr. |
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. 1610612750 |
sr_id | team | GUID | Unique Sportradar ID of a team ex. sr:team:3415 |
Coach:
Attribute | Parent Element | Type | Description |
---|---|---|---|
first_name | coach | String | First name of a coach ex. Steve |
full_name | coach | String | Full name of a coach ex. Steve Kerr |
id | coach | GUID | Unique ID of a coach ex. 04bb3fde-d798-44a1-a4c1-2c98c9bbf04b |
last_name | coach | String | Last name of a coach ex. Kerr |
position | coach | String | Position of a coach ex. Head Coach or Assistant Coach |
reference | coach | String | League reference ID of a coach ex. 204005 |
Venue:
Attribute | Parent Element | Type | Description |
---|---|---|---|
address | venue | String | Address of a venue ex. 500 David J. Stern Walkway |
capacity | venue | String | Capacity of a venue ex. 17608 |
city | venue | String | City of a venue ex. Sacramento |
country | venue | String | Country of a venue ex. USA |
id | venue | GUID | Unique ID of a venue ex. 2e687b9a-c7a7-487c-85b4-43479abc8458 |
lat | venue - location | Decimal | Latitude of a venue ex. 29.684735 |
lng | venue - location | Decimal | Longitude of a venue ex. -95.410725 |
name | venue | String | Name of a venue ex. Golden 1 Center |
sr_id | venue | GUID | Unique Sportradar ID of a venue ex. sr:venue:6942 |
state | venue | String | State or province of a venue ex. CA |
zip | venue | Integer | ZIP code of a venue ex. 95814 |