NBA G League Game Play-by-Play Detailed, real-time information on every team possession and game event.
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. 2a29bf58-7069-4ca4-8933-0347544e243d |
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 |
lead_changes | game - quarter / overtime - scoring | Integer | Number of lead changes in a quarter |
times_tied | game - quarter / overtime - scoring | Integer | Number of times tied in a quarter |
id | overtime | GUID | Unique ID of overtime ex. 1c2463d7-43ec-4b83-a29c-d66087d8e8df |
number | overtime | Integer | Overtime number |
sequence | overtime | Integer | Period sequence number (The first overtime sequence would be 5 ) |
quarter | game | Integer | Quarter number of the game |
id | quarter | GUID | Unique ID of a quarter ex. 47091cc4-08c2-4f83-9d8d-59c3c85e1725 |
number | quarter | Integer | Quarter number |
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 |
|
| GUID | Standard parent ID of a game. Use this ID to group events across seasons |
|
| Integer | Current quarter of a game |
|
| String | League reference ID of a game |
|
| String | The status of a gamescheduled , 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 |
|
| 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. 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 |
Play-by-Play - Attribution & Possession:
Attribution is the team associated with the play-by-play event (i.e. the statistic associated with it). Possession is the team who currently has the possession of the ball as a result of that play-by-play event.
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | event - attribution | GUID | Unique ID of a team ex. 67a79348-041a-45f6-bb12-722d38dc8dbf |
market | event - attribution | String | Market name of a team ex. Delaware |
name | event - attribution | String | Team name ex. Blue Coats |
team_basket | event - attribution | String | The basket the offensive team is shooting at in the arena. Direction is based on the TV broadcast's perspective.left , right |
id | event - possession | GUID | Unique ID of a team ex. 67a79348-041a-45f6-bb12-722d38dc8dbf |
market | event - possession | String | Market name of a team ex. Delaware |
name | event - possession | String | Team name ex. Blue Coats |
team_basket | event - possession | String | The basket the offensive team is shooting at in the arena. Direction is based on the TV broadcast's perspective.left , right |
Play-by-Play - Home/Away Teams:
Attribute | Parent Element | Type | Description |
---|---|---|---|
alias | scoring / quarter - away | String | Abbreviation of the away team ex. DEL (Delaware) |
bonus | scoring / quarter - away | Boolean | Signifies a team is in the bonus |
points | scoring - away | Integer | Total points for the away team |
points | quarter - away | Integer | Points in a quarter for the away team |
id | scoring / quarter - away | GUID | Unique ID of the away team ex. 67a79348-041a-45f6-bb12-722d38dc8dbf |
market | scoring / quarter - away | String | Market name of the away team ex. Delaware |
name | scoring / quarter - away | String | Away team name ex. Blue Coats |
alias | scoring / quarter - home | String | Abbreviation of the home team ex. DEL (Delaware) |
bonus | scoring / quarter - home | Boolean | Signifies a team is in the bonus |
points | scoring - home | Integer | Total points for the home team |
points | quarter - home | Integer | Points in a quarter for the home team |
id | scoring / quarter - home | GUID | Unique ID of the home team ex. 67a79348-041a-45f6-bb12-722d38dc8dbf |
market | scoring / quarter - home | String | Market name of the home team ex. Delaware |
name | scoring / quarter - home | String | Home team name ex. Blue Coats |
Play-by-Play - Event:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| String | Clock value in decimal form when the game clock is under 1:00. Otherwise it displays the same value as |
|
| String | Text description of a free throw attempt |
|
| Integer | Total points for the away team after an event |
|
| String | Clock value of an event |
|
| String | Text description of an event |
|
| String | Type of event |
|
| String | Type of free throw |
|
| Integer | Total points for the home team after an event |
|
| GUID | Unique ID of an event |
|
| String | Action area of an event |
|
| Integer | X coordinate of an event. The court we use is 1128 by 600; the scale is in inches. |
|
| Integer | Y coordinate of an event. The court we use is 1128 by 600; the scale is in inches. |
|
| Integer | Sequential number of an event in a game |
|
| String | Additional descriptor of a play-by-play event type. |
|
| Boolean | Signifies a technical foul |
|
| Integer | UNIX timestamp of the wall clock value. Use this value to help sequence play-by-play events (smallest to largest sequence number}. |
|
| String | Type of turnover |
|
| dateTime | Timestamp of the creation of an event |
|
| dateTime | Timestamp of the last update to an event |
|
| dateTime | Timestamp in UTC when the on-venue statistician began entry of a play-by-play event. |
Play-by-Play - Play Participants & Stats:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| GUID | Unique ID of a team |
|
| String | Market name of a team |
|
| String | Team name |
|
| String | Full name of a player |
|
| GUID | Unique player ID |
|
| Integer | Number of a player's jersey |
|
| Boolean | Signifies a made basket |
|
| Integer | Number of points scored for an event |
|
| String | Rebound type |
|
| Decimal | Shot distance in feet from the basket |
|
| String | Shot type |
|
| String | Text description of a shot type |
|
| Boolean | Signifies a 3-point attempt |
|
| Boolean | Signifies a made free throw |
|
| Integer | Number of points scored for a free throw |
|
| String | Type of free throw |
Play-by-Play - On Court Participants:
Attribute | Parent Element | Type | Description |
---|---|---|---|
full_name | event - on_court - player | String | Full name of a player ex. Mac McClung |
id | event - on_court - player | GUID | Unique player ID ex. a7ad124e-7060-402d-8ad3-a982af52eb93 |
jersey_number | event - on_court - player | Integer | Number of a player's jersey |
id | event - on_court - home / away | GUID | Unique ID of a team ex. 67a79348-041a-45f6-bb12-722d38dc8dbf |
market | event - on_court - home / away | String | Market name of a team ex. Delaware |
name | event - on_court - home / away | String | Team name ex. Blue Coats |