College Basketball Data API
​integer · int32 · required​integer · int32 · required​string · date-time · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​string · required​string | null · required
​integer · int32 · required​integer · int32 · required​integer · int32 · required​string · date-time · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​string · required​string | null · required
​integer · int32 · required​string · required​integer · int32 · required​string · date-time · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​string · required​string | null · required
​integer · int32 · required​boolean​integer · int32 · required​string · required​integer · int32 · required​string · required​string · date-time · required​number · double · required​SeasonType · enum · required​string · required​string | null · required​string · required​boolean | null · required​integer | null · int32 · required​string | null · required​string | null · required​number | null · double · required​integer | null · int32 · required​string | null · required​string | null · required​number | null · double · required​integer · int32 · required​string · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​number | null · double · required​boolean | null · required​boolean | null · required​number | null · double · required​string | null · date-time · required​string | null · required
​integer · int32 · required​integer · int32 · required​boolean​integer · int32 · required​string · required​integer · int32 · required​string · required​string · date-time · required​number · double · required​SeasonType · enum · required​string · required​string | null · required​string · required​boolean | null · required​integer | null · int32 · required​string | null · required​string | null · required​number | null · double · required​integer | null · int32 · required​string | null · required​string | null · required​number | null · double · required​integer · int32 · required​string · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​number | null · double · required​boolean | null · required​boolean | null · required​number | null · double · required​string | null · date-time · required​string | null · required
​integer · int32 · required​string · required​boolean​integer · int32 · required​string · required​integer · int32 · required​string · required​string · date-time · required​number · double · required​SeasonType · enum · required​string · required​string | null · required​string · required​boolean | null · required​integer | null · int32 · required​string | null · required​string | null · required​number | null · double · required​integer | null · int32 · required​string | null · required​string | null · required​number | null · double · required​integer · int32 · required​string · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​number | null · double · required​boolean | null · required​boolean | null · required​number | null · double · required​string | null · date-time · required​string | null · required
​string · date-time · required​boolean​number · double​integer · int32 · required​string · required​integer · int32 · required​string · required​string · date-time · required​number · double · required​SeasonType · enum · required​string · required​string | null · required​string · required​boolean | null · required​integer | null · int32 · required​string | null · required​string | null · required​number | null · double · required​integer | null · int32 · required​string | null · required​string | null · required​number | null · double · required​integer · int32 · required​string · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​number | null · double · required​boolean | null · required​boolean | null · required​number | null · double · required​string | null · date-time · required​string | null · required
​string · required​number · double · required​boolean​integer · int32 · required​string · required​integer · int32 · required​string · required​string · date-time · required​number · double · required​SeasonType · enum · required​string · required​string | null · required​string · required​boolean | null · required​integer | null · int32 · required​string | null · required​string | null · required​number | null · double · required​integer | null · int32 · required​string | null · required​string | null · required​number | null · double · required​integer · int32 · required​string · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​number | null · double · required​boolean | null · required​boolean | null · required​number | null · double · required​string | null · date-time · required​string | null · required
Play-by-play data and substitution events.
GET
https://api.collegebasketballdata.com
/substitutions/game/{gameId}
Bearer
Returns all recorded player substitutions for a game.
path Parameters
gameIdThe game ID.
Responses
200
Ok
gameIdstartDateteamIdteamconferenceathleteIdathletepositionopponentIdopponentopponentConference​object · required
​object · required
GET
https://api.collegebasketballdata.com
/substitutions/player/{playerId}
Bearer
Returns all recorded player substitutions for a player and season.
path Parameters
playerIdThe player ID.
query Parameters
seasonThe season to return.
Responses
200
Ok
gameIdstartDateteamIdteamconferenceathleteIdathletepositionopponentIdopponentopponentConference​object · required
​object · required
GET
https://api.collegebasketballdata.com
/substitutions/team
Bearer
Returns all recorded player substitutions for a team and season.
query Parameters
seasonThe season to return.
teamThe team name to return.
Responses
200
Ok
gameIdstartDateteamIdteamconferenceathleteIdathletepositionopponentIdopponentopponentConference​object · required
​object · required
GET
https://api.collegebasketballdata.com
/plays/game/{gameId}
Bearer
Returns all recorded plays for a game.
path Parameters
gameIdThe game ID.
query Parameters
shootingPlaysOnlyWhen true, returns only shooting plays.
Responses
200
Ok
​PlayInfo[]
idsourceIdgameIdgameSourceIdgameStartDateseasonseasonTypeEnum values:
postseason
preseason
regular
gameTypetournamentplayTypeisHomeTeamteamIdteamconferenceteamSeedopponentIdopponentopponentConferenceopponentSeedperiodclocksecondsRemaininghomeScoreawayScorehomeWinProbabilityscoringPlayshootingPlayscoreValuewallclockplayText​object[] · required
​object[] · required
​object · required
GET
https://api.collegebasketballdata.com
/plays/player/{playerId}
Bearer
Returns all recorded plays for a player and season.
path Parameters
playerIdThe player ID.
query Parameters
seasonThe season to return.
shootingPlaysOnlyWhen true, returns only shooting plays.
Responses
200
Ok
​PlayInfo[]
idsourceIdgameIdgameSourceIdgameStartDateseasonseasonTypeEnum values:
postseason
preseason
regular
gameTypetournamentplayTypeisHomeTeamteamIdteamconferenceteamSeedopponentIdopponentopponentConferenceopponentSeedperiodclocksecondsRemaininghomeScoreawayScorehomeWinProbabilityscoringPlayshootingPlayscoreValuewallclockplayText​object[] · required
​object[] · required
​object · required
GET
https://api.collegebasketballdata.com
/plays/team
Bearer
Returns all recorded plays for a team and season.
query Parameters
seasonThe season to return.
teamThe team name to return.
shootingPlaysOnlyWhen true, returns only shooting plays.
Responses
200
Ok
​PlayInfo[]
idsourceIdgameIdgameSourceIdgameStartDateseasonseasonTypeEnum values:
postseason
preseason
regular
gameTypetournamentplayTypeisHomeTeamteamIdteamconferenceteamSeedopponentIdopponentopponentConferenceopponentSeedperiodclocksecondsRemaininghomeScoreawayScorehomeWinProbabilityscoringPlayshootingPlayscoreValuewallclockplayText​object[] · required
​object[] · required
​object · required
GET
https://api.collegebasketballdata.com
/plays/date
Bearer
Returns all recorded plays for a UTC date.
query Parameters
dateThe date to return in ISO 8601 format (YYYY-MM-DD).
shootingPlaysOnlyWhen true, returns only shooting plays.
utcOffsetShifts the date range by this number of hours from UTC.
Responses
200
Ok
​PlayInfo[]
idsourceIdgameIdgameSourceIdgameStartDateseasonseasonTypeEnum values:
postseason
preseason
regular
gameTypetournamentplayTypeisHomeTeamteamIdteamconferenceteamSeedopponentIdopponentopponentConferenceopponentSeedperiodclocksecondsRemaininghomeScoreawayScorehomeWinProbabilityscoringPlayshootingPlayscoreValuewallclockplayText​object[] · required
​object[] · required
​object · required
GET
https://api.collegebasketballdata.com
/plays/tournament
Bearer
Returns all recorded plays for a tournament and season.
query Parameters
tournamentThe tournament to return, such as NCAA or NIT.
seasonThe season to return.
shootingPlaysOnlyWhen true, returns only shooting plays.
Responses
200
Ok
​PlayInfo[]
idsourceIdgameIdgameSourceIdgameStartDateseasonseasonTypeEnum values:
postseason
preseason
regular
gameTypetournamentplayTypeisHomeTeamteamIdteamconferenceteamSeedopponentIdopponentopponentConferenceopponentSeedperiodclocksecondsRemaininghomeScoreawayScorehomeWinProbabilityscoringPlayshootingPlayscoreValuewallclockplayText​object[] · required
​object[] · required
​object · required