Docs
Coverage MatrixDocumentationRelease LogLog In

Play-By-Play

NCAAWB 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

Boxscore:
AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game
ex. 19079
lead_changesgameIntegerNumber of lead changes in a game
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:
AttributeParent ElementTypeDescription
aliasawayStringAbbreviation of the away team
ex. SCAR
idawayGUIDUnique ID of the away team
ex. 7269c5c7-6614-41d8-9415-7ca3243f6612
away_teamgameGUIDUnique ID of the away team
ex. 7269c5c7-6614-41d8-9415-7ca3243f6612
conference_gamegameStringSignifies an in-Conference matchup
ex. (SEC vs. SEC)
nameawayStringTeam name of the away team
ex. Gamecocks
rankawayIntegerTeam rank in the AP Top 25. Value represents the team's rank at the time the game was moved to created status.
entry_modegameStringType of data entry for the game
LDE (Live Data Entry by Sportradar)
clockgameStringClock value of the game
ex. 12:37
clock_decimalgameStringClock value in decimal form when the game clock is under 1:00. Otherwise it displays the same value as clock
ex. 00:21.70
coveragegameStringCoverage level of a game
full, extended_boxscore
durationgameStringDuration of a game
ex. 2:26
idgameGUIDUnique ID of a game
ex. 1f730a9a-8221-48ff-a259-ac2103fb58b0
quartergameIntegerCurrent quarter of a game
statusgameStringThe 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
titlegameStringTitle of a game
ex. Seattle 4 - First Round - Game 8
aliashomeStringAbbreviation of the home team
ex. IOWA
idhomeGUIDUnique ID of the home team
ex. 7269c5c7-6614-41d8-9415-7ca3243f6612
home_teamgameGUIDUnique ID of the home team
ex. 7269c5c7-6614-41d8-9415-7ca3243f6612
namehomeStringTeam name of the home team
ex. Hawkeyes
rankhomeIntegerTeam rank in the AP Top 25. Value represents the team's rank at the time the game was moved to created status.
neutral_sitegameBooleanSignifies a game played at a neutral venue
scheduledgamedateTimeScheduled date and time of a game
ex. 2022-09-25T20:10:00+00:00
awaygame - time_zonesStringTime zone of the away team
ex. US/Pacific
homegame - time_zonesStringTime zone of the home team
ex. US/Eastern
venuegame - time_zonesStringTime zone of the venue
ex. US/Eastern
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:
AttributeParent ElementTypeDescription
attempteventStringText description of a free throw attempt
ex. 1 of 2 or 2 of 2
away_pointseventIntegerTotal points for the away team after an event
clockeventStringClock value of an event
ex. 12:37
clock_decimaleventStringClock value in decimal form when the game clock is under 1:00. Otherwise it displays the same value as clock
ex. 00:21.70
descriptioneventStringText description of an event
ex. Caitlin Clark makes three point pullup jump shot
event_typeeventStringType of event
ex. turnover or rebound
See our FAQ for a complete list of types
free_throw_typeeventStringType of free throw
ex. regular, technical, flagrant, clear path
home_pointseventIntegerTotal points for the home team after an event
ideventGUIDUnique ID of an event
ex. f374579b-78f6-410a-a73e-56ba96b99f6a
action_areaevent - locationStringAction area of an event
underbasket, inthepaint, insiderightwing, insideright, insidecenter, insideleft, insideleftwing, outsideright, outsidecenter, outsideleft, outsideleftwing, backcourt
coord_xevent - locationIntegerX coordinate of an event. The court we use is 1128 by 600; the scale is in inches.
coord_yevent - locationIntegerY coordinate of an event. The court we use is 1128 by 600; the scale is in inches.
numbereventIntegerSequential number of an event in a game
sequenceeventIntegerUNIX timestamp of the wall clock value. Use this value to help sequence play-by-play events (smallest to largest sequence number}.
ex. 1678835426293
turnover_typeeventStringType of turnover
ex. Traveling or Lane Violation
updatedeventdateTimeTimestamp of the last update to an event
ex. 2022-09-25T23:00:45+00:00
Play-by-Play - Play Participants & Stats:
AttributeParent ElementTypeDescription
idevent - statistics - teamGUIDUnique ID of a team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketevent - statistics - teamStringMarket name of a team
ex. South Carolina
nameevent - statistics - teamStringTeam name
ex. Gamecocks
full_nameevent - statistics - playerStringFull name of a player
ex. Caitlin Clark
idevent - statistics - playerGUIDUnique player ID
ex. d8f2f455-ee4e-4061-8d1d-bd04131bd9a4
jersey_numberevent - statistics - playerIntegerNumber of a player's jersey
madeevent - statistics - fieldgoalBooleanSignifies a made basket
pointsevent - statistics - fieldgoalIntegerNumber of points scored for an event
rebound_typeevent - statistics - reboundStringRebound type
defensive, offensive
shot_typeevent - statistics - fieldgoalStringShot type
jump shot, layup, dunk, hook, tip
shot_type_descevent - statistics - fieldgoalStringText description of a shot type
ex. driving or alley-oop
See our FAQ for a complete list of descriptions
three_point_shotevent - statistics - fieldgoalBooleanSignifies a 3-point attempt
madeevent - statistics - freethrowBooleanSignifies a made free throw
pointsevent - statistics - freethrowIntegerNumber of points scored for a free throw
free_throw_typeevent - statistics - freethrowStringType 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
Authorization
Query
Click Try It! to start a request and see the response here!