Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Game Play-by-Play

NCAAWB Game Play-by-Play Detailed, real-time information on every team possession and game event.

⏱️

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, depending on coverage



Data Points

Season:
AttributeParent ElementTypeDescription
idgame - seasonGUIDUnique season ID
ex. 99709e03-9678-4ded-b848-3406ff731687
namegame - seasonStringName of the season
ex. Post-season
typegame - seasonStringType of the season
PRE, REG, PIT, PST
yeargame - seasonIntegerYear of the season
Boxscore:
AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game
ex. 19079
lead_changesgameIntegerNumber of lead changes in a game
possession_arrowgameGUIDUnique ID of the team with the current possession arrow (available for full coverage games only)
ex. 7269c5c7-6614-41d8-9415-7ca3243f6612
times_tiedgameIntegerNumber of times tied in a game
lead_changesgame - quarter / overtime - scoringIntegerNumber of lead changes in a quarter
times_tiedgame - quarter / overtime - scoringIntegerNumber of times tied in a quarter
idovertimeGUIDUnique ID of overtime
ex. 1c2463d7-43ec-4b83-a29c-d66087d8e8df
numberovertimeIntegerOvertime number
sequenceovertimeIntegerPeriod sequence number (The first overtime sequence would be 5)
quartergameIntegerQuarter number of the game
idquarterGUIDUnique ID of a quarter
ex. 47091cc4-08c2-4f83-9d8d-59c3c85e1725
numberquarterIntegerQuarter number
sequencequarterIntegerQuarter sequence number
Game:

Attribute

Parent Element

Type

Description

alias

away

String

Abbreviation of the away team
ex. SCAR

id

away

GUID

Unique ID of the away team
ex. 7269c5c7-6614-41d8-9415-7ca3243f6612

away_team

game

GUID

Unique ID of the away team
ex. 7269c5c7-6614-41d8-9415-7ca3243f6612

conference_game

game

String

Signifies an in-Conference matchup
ex. (SEC vs. SEC)

name

away

String

Team name of the away team
ex. Gamecocks

rank

away

Integer

Team rank in the AP Top 25. Value represents the team's rank at the time the game was moved to created status.

remaining_timeouts

away

Integer

Remaining timeouts for the away team

entry_mode

game

String

Type of data entry for the game
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

parent_id

game

GUID

Standard parent ID of a game. Use this ID to group events (like conference tournaments) across seasons
ex. f3c4703e-678c-4338-90dd-116fc5e326c9

quarter

game

Integer

Current quarter of a game

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. Seattle 4 - First Round - Game 8

alias

home

String

Abbreviation of the home team
ex. IOWA

id

home

GUID

Unique ID of the home team
ex. 7269c5c7-6614-41d8-9415-7ca3243f6612

home_team

game

GUID

Unique ID of the home team
ex. 7269c5c7-6614-41d8-9415-7ca3243f6612

name

home

String

Team name of the home team
ex. Hawkeyes

rank

home

Integer

Team rank in the AP Top 25. Value represents the team's rank at the time the game was moved to created status.

remaining_timeouts

home

Integer

Remaining timeouts for the home team

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:
AttributeParent ElementTypeDescription
channelbroadcastStringName of a game's broadcast channel
ex. 208
localebroadcastStringSignifies the locale of a broadcast
ex. Home, Away, National
networkbroadcastStringName of a game's broadcast network
ex. ESPNU or ESPN+
typebroadcastStringType 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.

AttributeParent ElementTypeDescription
idevent - attributionGUIDUnique ID of a team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketevent - attributionStringMarket name of a team
ex. South Carolina
nameevent - attributionStringTeam name
ex. Gamecocks
team_basketevent - attributionStringThe basket the offensive team is shooting at in the arena. Direction is based on the TV broadcast's perspective.
left, right
idevent - possessionGUIDUnique ID of a team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketevent - possessionStringMarket name of a team
ex. South Carolina
nameevent - possessionStringTeam name
ex. Gamecocks
team_basketevent - possessionStringThe 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:
AttributeParent ElementTypeDescription
aliasscoring / quarter - awayStringAbbreviation of the away team
ex. SCAR
pointsgame - awayIntegerTotal points for the away team
pointsquarter - awayIntegerPoints in a quarter for the away team
idscoring / quarter - awayGUIDUnique ID of the away team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketscoring / quarter - awayStringMarket name of the away team
ex. South Carolina
namescoring / quarter - awayStringAway team name
ex. Gamecocks
aliasscoring / quarter - homeStringAbbreviation of the home team
ex. SCAR
pointsgame - homeIntegerTotal points for the home team
pointsquarter - homeIntegerPoints in a quarter for the home team
idscoring / quarter - homeGUIDUnique ID of the home team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketscoring / quarter - homeStringMarket name of the home team
ex. South Carolina
namescoring / quarter - homeStringHome team name
ex. Gamecocks
Play-by-Play - Event:

Attribute

Parent Element

Type

Description

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

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

description

event

String

Text description of an event
ex. Caitlin Clark makes three point pullup jump shot

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. f374579b-78f6-410a-a73e-56ba96b99f6a

action_area

event - location

String

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

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

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

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

Play-by-Play - Play Participants & Stats:

Attribute

Parent Element

Type

Description

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. South Carolina

name

event - statistics - team

String

Team name
ex. Gamecocks

full_name

event - statistics - player

String

Full name of a player
ex. Caitlin Clark

id

event - statistics - player

GUID

Unique player ID
ex. d8f2f455-ee4e-4061-8d1d-bd04131bd9a4

jersey_number

event - statistics - player

Integer

Number of a player's jersey

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_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

Player:
AttributeParent ElementTypeDescription
full_nameplayerStringFull name of a player
ex. Caitlin Clark
idplayerGUIDUnique ID of a player
ex. d8f2f455-ee4e-4061-8d1d-bd04131bd9a4
jersey_numberplayerIntegerNumber of a player's jersey
Team:
AttributeParent ElementTypeDescription
idteamGUIDUnique ID of a team
ex. 7269c5c7-6614-41d8-9415-7ca3243f6612
marketteamStringSchool name of a team
ex. Iowa
nameteamStringTeam name
ex. Hawkeyes
Language
Credentials
Header
Click Try It! to start a request and see the response here!