Docs
Coverage MatrixDocumentationRelease LogLog In

Play-By-Play

NCAAMB 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



Data Points

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. c2104cdc-c83d-40d2-a3cd-df986e29f5d3
times_tiedgameIntegerNumber of times tied in a game
lead_changesgame - half / overtime - scoringIntegerNumber of lead changes in a half
times_tiedgame - half / overtime - scoringIntegerNumber of times tied in a half
idovertimeGUIDUnique ID of overtime
ex. 1c2463d7-43ec-4b83-a29c-d66087d8e8df
numberovertimeIntegerOvertime number
sequenceovertimeIntegerPeriod sequence number (The first overtime sequence would be 3)
halfgameIntegerHalf number of the game
idhalfGUIDUnique ID of a half
ex. 47091cc4-08c2-4f83-9d8d-59c3c85e1725
numberhalfIntegerHalf number
Game:
AttributeParent ElementTypeDescription
aliasawayStringAbbreviation of the away team
ex. TCU
idawayGUIDUnique ID of the away team
ex. 583eca88-fb46-11e1-82cb-f4ce4684ea4c
away_teamgameGUIDUnique ID of the away team
ex. 583eca88-fb46-11e1-82cb-f4ce4684ea4c
bonusawayBooleanSignifies the away team is in the bonus (available for full coverage games only)
conference_gamegameStringSignifies an in-Conference matchup
ex. (SEC vs. SEC)
double_bonusawayBooleanSignifies the away team is in the double bonus (available for full coverage games only)
nameawayStringTeam name of the away team
ex. Horned Frogs
rankawayIntegerTeam rank in the AP Top 25. Value represents the team's rank at the time the game was moved to created status.
remaining_timeoutsawayIntegerRemaining timeouts for the away team
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
halfgameIntegerCurrent half 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. Patriot League - Quarterfinal 3
aliashomeStringAbbreviation of the home team
ex. TTU (Texas Tech University)
idhomeGUIDUnique ID of the home team
ex. f7fcbb6e-4a55-41ea-ba21-f763ed914467
home_teamgameGUIDUnique ID of the home team
ex. f7fcbb6e-4a55-41ea-ba21-f763ed914467
bonushomeBooleanSignifies the home team is in the bonus (available for full coverage games only)
double_bonushomeBooleanSignifies the home team is in the double bonus (available for full coverage games only)
namehomeStringTeam name of the home team
ex. Red Raiders
rankhomeIntegerTeam rank in the AP Top 25. Value represents the team's rank at the time the game was moved to created status.
remaining_timeoutshomeIntegerRemaining timeouts for the home team
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
track_on_courtgameBooleanSignifies 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
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. TCU
nameevent - attributionStringTeam name
ex. Horned Frogs
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. TCU
nameevent - possessionStringTeam name
ex. Horned Frogs
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 / half - awayStringAbbreviation of the away team
ex. TCU
bonusscoring / half - awayBooleanSignifies a team is in the bonus
pointsgame - awayIntegerTotal points for the away team
pointshalf - awayIntegerPoints in a half for the away team
idscoring / half - awayGUIDUnique ID of the away team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketscoring / half - awayStringMarket name of the away team
ex. TCU
namescoring / half - awayStringAway team name
ex. Horned Frogs
aliasscoring / half - homeStringAbbreviation of the home team
ex. TCU
bonusscoring / half - homeBooleanSignifies a team is in the bonus
pointsgame - homeIntegerTotal points for the home team
pointshalf - homeIntegerPoints in a half for the home team
idscoring / half - homeGUIDUnique ID of the home team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketscoring / half - homeStringMarket name of the home team
ex. TCU
namescoring / half - homeStringHome team name
ex. Horned Frogs
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. Jaylon Tyson makes three point jump shot (Fardaws Aimaq assists)
event_typeeventStringType of event
ex. turnover or rebound

See ourFAQ](https://developer.sportradar.com/basketball/reference/ncaamb-faq#event-types) 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. 034aca60-ec33-488f-aa05-b493aff755f7
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. TCU
nameevent - statistics - teamStringTeam name
ex. Horned Frogs
full_nameevent - statistics - playerStringFull name of a player
ex. Emanuel Miller
idevent - statistics - playerGUIDUnique player ID
ex. 3b1f1b14-b780-4012-850b-e0630abefb4d
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
Play-by-Play - On Court Participants:
AttributeParent ElementTypeDescription
full_nameevent - on_court - playerStringFull name of a player
ex. Emanuel Miller
idevent - on_court - playerGUIDUnique player ID
ex. 3b1f1b14-b780-4012-850b-e0630abefb4d
jersey_numberevent - on_court - playerIntegerNumber of a player's jersey
idevent - on_court - home / awayGUIDUnique ID of a team
ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c
marketevent - on_court - home / awayStringMarket name of a team
ex. TCU
nameevent - on_court - home / awayStringTeam name
ex. Horned Frogs
Player:
AttributeParent ElementTypeDescription
full_nameplayerStringFull name of a player
ex. Kris Murray
idplayerGUIDUnique ID of a player
ex. 0f46d12f-8a60-442f-8c8e-4c350aed6502
jersey_numberplayerIntegerNumber of a player's jersey
Team:
AttributeParent ElementTypeDescription
idteamGUIDUnique ID of a team
ex. c10544de-e3bd-4776-ba2e-83df8c017fd1
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!