NCAAMB 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. 415ae0cb-38dd-4ace-8f22-fb6015b39006 |
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 |
possession_arrow | game | GUID | Unique ID of the team with the current possession arrow (available for full coverage games only) ex. c2104cdc-c83d-40d2-a3cd-df986e29f5d3 |
times_tied | game | Integer | Number of times tied in a game |
lead_changes | game - half / overtime - scoring | Integer | Number of lead changes in a half |
times_tied | game - half / overtime - scoring | Integer | Number of times tied in a half |
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 3 ) |
half | game | Integer | Half number of the game |
id | half | GUID | Unique ID of a half ex. 47091cc4-08c2-4f83-9d8d-59c3c85e1725 |
number | half | Integer | Half number |
Game:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| String | Abbreviation of the away team |
|
| GUID | Unique ID of the away team |
|
| GUID | Unique ID of the away team |
|
| Boolean | Signifies the away team is in the bonus (available for full coverage games only) |
|
| String | Signifies an in-Conference matchup |
|
| Boolean | Signifies the away team is in the double bonus (available for full coverage games only) |
|
| String | Team name of the away team |
|
| Integer | Team rank in the AP Top 25. Value represents the team's rank at the time the game was moved to |
|
| Integer | Remaining timeouts for the away 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 (like conference tournaments) across seasons |
|
| Integer | Current half of a game |
|
| String | The status of a game Please see our FAQ section for a list of game status definitions |
|
| String | Title of a game |
|
| String | Abbreviation of the home team |
|
| GUID | Unique ID of the home team |
|
| GUID | Unique ID of the home team |
|
| Boolean | Signifies the home team is in the bonus (available for full coverage games only) |
|
| Boolean | Signifies the home team is in the double bonus (available for full coverage games only) |
|
| String | Team name of the home team |
|
| Integer | Team rank in the AP Top 25. Value represents the team's rank at the time the game was moved to |
|
| Integer | Remaining timeouts for the home team |
|
| 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 |
|
| Boolean | Signifies a game with live tracking of players on the court when |
Broadcast:
Attribute | Parent Element | Type | Description |
---|---|---|---|
channel | broadcast | String | Name of a game's broadcast channel ex. 208 |
locale | broadcast | String | Signifies the locale of a broadcast ex. Home , Away , National |
network | broadcast | String | Name of a game's broadcast network ex. ESPNU or ESPN+ |
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. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c |
market | event - attribution | String | Market name of a team ex. TCU |
name | event - attribution | String | Team name ex. Horned Frogs |
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. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c |
market | event - possession | String | Market name of a team ex. TCU |
name | event - possession | String | Team name ex. Horned Frogs |
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 / half - away | String | Abbreviation of the away team ex. TCU |
bonus | scoring / half - away | Boolean | Signifies a team is in the bonus |
points | game - away | Integer | Total points for the away team |
points | half - away | Integer | Points in a half for the away team |
id | scoring / half - away | GUID | Unique ID of the away team ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c |
market | scoring / half - away | String | Market name of the away team ex. TCU |
name | scoring / half - away | String | Away team name ex. Horned Frogs |
alias | scoring / half - home | String | Abbreviation of the home team ex. TCU |
bonus | scoring / half - home | Boolean | Signifies a team is in the bonus |
points | game - home | Integer | Total points for the home team |
points | half - home | Integer | Points in a half for the home team |
id | scoring / half - home | GUID | Unique ID of the home team ex. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c |
market | scoring / half - home | String | Market name of the home team ex. TCU |
name | scoring / half - home | String | Home team name ex. Horned Frogs |
Play-by-Play - Event:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| 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 | Clock value in decimal form when the game clock is under 1:00. Otherwise it displays the same value as |
|
| String | Text description of an event |
|
| String | Type of event See our FAQ for a complete list of types |
|
| 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 |
|
| 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 |
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 |
|
| 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. Emanuel Miller |
id | event - on_court - player | GUID | Unique player ID ex. 3b1f1b14-b780-4012-850b-e0630abefb4d |
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. 583ed0ac-fb46-11e1-82cb-f4ce4684ea4c |
market | event - on_court - home / away | String | Market name of a team ex. TCU |
name | event - on_court - home / away | String | Team name ex. Horned Frogs |
Player:
Attribute | Parent Element | Type | Description |
---|---|---|---|
full_name | player | String | Full name of a player ex. Kris Murray |
id | player | GUID | Unique ID of a player ex. 0f46d12f-8a60-442f-8c8e-4c350aed6502 |
jersey_number | player | Integer | Number of a player's jersey |
Team:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | team | GUID | Unique ID of a team ex. c10544de-e3bd-4776-ba2e-83df8c017fd1 |
market | team | String | School name of a team ex. Iowa |
name | team | String | Team name ex. Hawkeyes |