Game Play-by-Play

alias

away

String

Abbreviation of the away team
ex. MEM (Memphis)

id

away

GUID

Unique ID of the away team
ex. 583eca88-fb46-11e1-82cb-f4ce4684ea4c

away_team

game

GUID

Unique ID of the away team
ex. 583eca88-fb46-11e1-82cb-f4ce4684ea4c

name

away

String

Team name of the away team
ex. Memphis Grizzlies

reference

away

String

League reference ID of the away team
ex. 1610612750

remaining_timeouts

away

Integer

Remaining timeouts for the away team

sr_id

away

GUID

Unique Sportradar ID of the away team
ex. sr:team:3415

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

Title of a game
ex. Game 3

alias

home

String

Abbreviation of the home team
ex. GSW (Golden State)

id

home

GUID

Unique ID of the home team
ex. 583ec825-fb46-11e1-82cb-f4ce4684ea4c

home_team

game

GUID

Unique ID of the home team
ex. 583ec825-fb46-11e1-82cb-f4ce4684ea4c

name

home

String

Team name of the home team
ex. Golden State Warriors

reference

home

String

League reference ID of the home team
ex. 1610612750

remaining_timeouts

home

Integer

Remaining timeouts for the home team

sr_id

home

GUID

Unique Sportradar ID of the home team
ex. sr:team:3428

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

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

clock_decimal

event

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

attempt

event

String

Text description of a free throw attempt
ex. 1 of 2 or 2 of 2

away_points

event

Integer

Total points for the away team after an event

clock

event

String

Clock value of an event
ex. 12:37

description

event

String

Text description of an event
ex. Kevon Looney makes two point jump shot (Klay Thompson assists)

event_type

event

String

Type of event
ex. turnover or rebound

See our FAQ for a complete list of types

free_throw_type

event

String

Type of free throw
ex. regular, technical, flagrant, clear path

home_points

event

Integer

Total points for the home team after an event

id

event

GUID

Unique ID of an event
ex. b9feda23-c03f-4304-afa4-06d7dc830651

action_area

event - location

String

Action area of an event
underbasket, inthepaint, insiderightwing, insideright, insidecenter, insideleft, insideleftwing, outsideright, outsidecenter, outsideleft, outsideleftwing, backcourt

Please see our FAQ for detailed plot points of our action areas

coord_x

event - location

Integer

X coordinate of an event. The court we use is 1128 by 600; the scale is in inches.

coord_y

event - location

Integer

Y coordinate of an event. The court we use is 1128 by 600; the scale is in inches.

number

event

Integer

Sequential number of an event in a game

qualifier

events - qualifiers - qualifier

String

Additional descriptor of a play-by-play event type.
Appears only in JSON format
2ndchance, fastbreak, fromturnover, defensivegoaltending, pointsinthepaint, fastbreak, fromturnover, team, deadball, 1freethrow.2freethrow, mandatory

rescinded

event

Boolean

Signifies a technical foul event_type="technicalfoul") has been rescinded by the league when true

sequence

event

Integer

UNIX timestamp of the wall clock value. Use this value to help sequence play-by-play events (smallest to largest sequence number).
ex. 1678835426293

turnover_type

event

String

Type of turnover
ex. Traveling or Lane Violation

See our FAQ for a complete list of types

created

event

dateTime

Timestamp of the creation of an event
ex. 2024-02-14T05:00:00Z

updated

event

dateTime

Timestamp of the last update to an event
ex. 2024-02-14T05:00:00Z

wall_clock

event

dateTime

Timestamp in UTC when the on-venue statistician began entry of a play-by-play event.
ex. 2024-02-14T05:00:00Z

id

event - statistics - team

GUID

Unique ID of a team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c

market

event - statistics - team

String

Market name of a team
ex. Sacramento

name

event - statistics - team

String

Team name
ex. Kings

reference

event - statistics - team

String

League reference ID of a team
ex. 1610612750

sr_id

event - statistics - team

GUID

Unique Sportradar ID of a team
ex. sr:team:3415

full_name

event - statistics - player

String

Full name of a player
ex. Stephen Curry

id

event - statistics - player

GUID

Unique player ID
ex. 8ec91366-faea-4196-bbfd-b8fab7434795

jersey_number

event - statistics - player

Integer

Number of a player's jersey

reference

event - statistics - player

String

League reference ID of a player
ex. 1626157

sr_id

event - statistics - player

GUID

Unique Sportradar ID of a player
ex. sr:player:608110

made

event - statistics - fieldgoal

Boolean

Signifies a made basket

points

event - statistics - fieldgoal

Integer

Number of points scored for an event

rebound_type

event - statistics - rebound

String

Rebound type
defensive, offensive

shot_distance

event - statistics - fieldgoal

Decimal

Shot distance in feet from the basket
ex. 2.37

shot_type

event - statistics - fieldgoal

String

Shot type
jump shot, layup, dunk, hook, tip

shot_type_desc

event - statistics - fieldgoal

String

Text description of a shot type
ex. driving or alley-oop

See our FAQ for a complete list of descriptions

three_point_shot

event - statistics - fieldgoal

Boolean

Signifies a 3-point attempt

made

event - statistics - freethrow

Boolean

Signifies a made free throw

points

event - statistics - freethrow

Integer

Number of points scored for a free throw

free_throw_type

event - statistics - freethrow

String

Type of free throw
ex. regular, technical, flagrant, clear path