College Basketball DataCollege Basketball Data
  • CollegeBasketballData.com
  • Get API Key
  • Legacy Swagger UI
  • Getting Started
  • Official libraries
  • API Reference
Helpful links
  • CBBD
  • Get API key
  • Access tiers
Official libraries
  • Python
  • TypeScript
  • R
  • API source
Other resources
  • Rad Sports Analytics
  • Football
  • CBB Starter Pack

A Rad Sports Analytics platform.

xdiscordgithub
Information
Games
    /gamesget/games/mediaget/games/teamsget/games/playersget/scoreboardget
Plays
    /substitutions/game/{gameId}get/substitutions/player/{playerId}get/substitutions/teamget/plays/game/{gameId}get/plays/player/{playerId}get/plays/teamget/plays/dateget/plays/tournamentget/plays/typesget
Teams
    /teamsget/teams/rosterget
Conferences
    /conferencesget/conferences/historyget
Venues
    /venuesget
Stats
    /stats/team/leaderboardget/stats/team/seasonget/stats/team/shooting/seasonget/stats/player/seasonget/stats/player/shooting/seasonget
Rankings
    /rankingsget
Ratings
    /ratings/srsget/ratings/adjustedget/ratings/eloget
Lines
    /linesget/lines/providersget
Lineups
    /lineups/teamget/lineups/game/{gameId}get
Draft
    /draft/teamsget/draft/positionsget/draft/picksget
Recruiting
    /recruiting/playersget/recruiting/teamsget/recruiting/portalget
Schemas
powered by Zudoku
College Basketball Data API
College Basketball Data API

Games

Download schema

Game schedules, scores, broadcasts, and box scores.


GET
https://api.collegebasketballdata.com
/games
Bearer

Returns up to 3,000 games that match the filters, ordered by start date.

query Parameters

startDateRange
​string · date-time

Includes games starting at or after this ISO 8601 timestamp.

endDateRange
​string · date-time

Includes games starting at or before this ISO 8601 timestamp.

team
​string

Filters results to the specified team name.

conference
​string

Filters results to the specified conference abbreviation.

season
​integer · int32

Filters results to the specified season.

seasonType
​SeasonType · enum

Filters results to the specified season type.

Enum values:
postseason
preseason
regular
status
​GameStatus · enum

Filters results to the specified game status.

Enum values:
scheduled
in_progress
final
postponed
cancelled
tournament
​string

Filters results to the specified tournament, such as NCAA or NIT.

Responses

200

Ok

​GameInfo[]
GameInfo
id
​integer · int32 · required
sourceId
​string · required
seasonLabel
​string · required
season
​integer · int32 · required
seasonType
​SeasonType · enum · required
Enum values:
postseason
preseason
regular
startDate
​string · date-time · required
startTimeTbd
​boolean · required
neutralSite
​boolean · required
conferenceGame
​boolean · required
gameType
​string | null · required
tournament
​string | null · required
gameNotes
​string | null · required
status
​GameStatus · enum · required
Enum values:
scheduled
in_progress
final
postponed
cancelled
attendance
​integer | null · int32 · required
homeTeamId
​integer · int32 · required
homeTeam
​string · required
homeConferenceId
​integer | null · int32 · required
homeConference
​string | null · required
homeSeed
​integer | null · int32 · required
homePoints
​integer | null · int32 · required
homePeriodPoints
​array | null · required
homeWinner
​boolean | null · required
homeTeamEloStart
​integer | null · int32 · required
homeTeamEloEnd
​integer | null · int32 · required
awayTeamId
​integer · int32 · required
awayTeam
​string · required
awayConferenceId
​integer | null · int32 · required
awayConference
​string | null · required
awaySeed
​integer | null · int32 · required
awayPoints
​integer | null · int32 · required
awayPeriodPoints
​array | null · required
awayWinner
​boolean | null · required
awayTeamEloStart
​integer | null · int32 · required
awayTeamEloEnd
​integer | null · int32 · required
excitement
​number | null · double · required
venueId
​integer | null · int32 · required
venue
​string | null · required
city
​string | null · required
state
​string | null · required
GET/games
curl https://api.collegebasketballdata.com/games \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "id": 0, "sourceId": "sourceId", "seasonLabel": "seasonLabel", "season": 0, "seasonType": "postseason", "startDate": "2024-08-25T15:00:00Z", "startTimeTbd": true, "neutralSite": true, "conferenceGame": true, "gameType": "gameType", "tournament": "tournament", "gameNotes": "gameNotes", "status": "scheduled", "attendance": 0, "homeTeamId": 0, "homeTeam": "homeTeam", "homeConferenceId": 0, "homeConference": "homeConference", "homeSeed": 0, "homePoints": 0, "homePeriodPoints": [ 0 ], "homeWinner": true, "homeTeamEloStart": 0, "homeTeamEloEnd": 0, "awayTeamId": 0, "awayTeam": "awayTeam", "awayConferenceId": 0, "awayConference": "awayConference", "awaySeed": 0, "awayPoints": 0, "awayPeriodPoints": [ 0 ], "awayWinner": true, "awayTeamEloStart": 0, "awayTeamEloEnd": 0, "excitement": 0, "venueId": 0, "venue": "venue", "city": "city", "state": "state" } ]
json
application/json

GET
https://api.collegebasketballdata.com
/games/media
Bearer

Returns broadcast records for up to 3,000 games that match the filters, ordered by start date.

query Parameters

startDateRange
​string · date-time

Includes games starting at or after this ISO 8601 timestamp.

endDateRange
​string · date-time

Includes games starting at or before this ISO 8601 timestamp.

team
​string

Filters results to the specified team name.

conference
​string

Filters results to the specified conference abbreviation.

season
​number · double

Filters results to the specified season.

seasonType
​SeasonType · enum

Filters results to the specified season type.

Enum values:
postseason
preseason
regular
tournament
​string

Filters results to the specified tournament, such as NCAA or NIT.

Responses

200

Ok

​GameMediaInfo[]
GameMediaInfo
gameId
​integer · int32 · required
season
​integer · int32 · required
seasonLabel
​string · required
seasonType
​SeasonType · enum · required
Enum values:
postseason
preseason
regular
tournament
​string | null · required
startDate
​string · date-time · required
startTimeTbd
​boolean · required
homeTeamId
​integer · int32 · required
homeTeam
​string · required
homeConference
​string | null · required
awayTeamId
​integer · int32 · required
awayTeam
​string · required
awayConference
​string | null · required
neutralSite
​boolean · required
conferenceGame
​boolean · required
gameType
​string | null · required
notes
​string | null · required
​object[] · required
GET/games/media
curl https://api.collegebasketballdata.com/games/media \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "gameId": 0, "season": 0, "seasonLabel": "seasonLabel", "seasonType": "postseason", "tournament": "tournament", "startDate": "2024-08-25T15:00:00Z", "startTimeTbd": true, "homeTeamId": 0, "homeTeam": "homeTeam", "homeConference": "homeConference", "awayTeamId": 0, "awayTeam": "awayTeam", "awayConference": "awayConference", "neutralSite": true, "conferenceGame": true, "gameType": "gameType", "notes": "notes", "broadcasts": [ { "broadcastName": "broadcastName", "broadcastType": "broadcastType" } ] } ]
json
application/json

GET
https://api.collegebasketballdata.com
/games/teams
Bearer

Returns team box scores and advanced metrics for up to 3,000 games that match the filters, ordered by start date.

query Parameters

startDateRange
​string · date-time

Includes games starting at or after this ISO 8601 timestamp.

endDateRange
​string · date-time

Includes games starting at or before this ISO 8601 timestamp.

team
​string

Filters results to the specified team name.

conference
​string

Filters results to the specified conference abbreviation.

season
​number · double

Filters results to the specified season.

seasonType
​SeasonType · enum

Filters results to the specified season type.

Enum values:
postseason
preseason
regular
tournament
​string

Filters results to the specified tournament, such as NCAA or NIT.

Responses

200

Ok

​GameBoxScoreTeam[]
GameBoxScoreTeam
gameId
​integer · int32 · required
season
​integer · int32 · required
seasonLabel
​string · required
seasonType
​SeasonType · enum · required
Enum values:
postseason
preseason
regular
tournament
​string | null · required
startDate
​string · date-time · required
startTimeTbd
​boolean · required
teamId
​integer · int32 · required
team
​string · required
conference
​string | null · required
teamSeed
​integer | null · int32 · required
opponentId
​integer · int32 · required
opponent
​string · required
opponentConference
​string | null · required
opponentSeed
​integer | null · int32 · required
neutralSite
​boolean · required
isHome
​boolean · required
conferenceGame
​boolean · required
gameType
​string | null · required
notes
​string | null · required
gameMinutes
​number | null · double · required
pace
​number | null · double · required
​GameBoxScoreTeamStats · required
​GameBoxScoreTeamStats · required
GET/games/teams
curl https://api.collegebasketballdata.com/games/teams \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "gameId": 0, "season": 0, "seasonLabel": "seasonLabel", "seasonType": "postseason", "tournament": "tournament", "startDate": "2024-08-25T15:00:00Z", "startTimeTbd": true, "teamId": 0, "team": "team", "conference": "conference", "teamSeed": 0, "opponentId": 0, "opponent": "opponent", "opponentConference": "opponentConference", "opponentSeed": 0, "neutralSite": true, "isHome": true, "conferenceGame": true, "gameType": "gameType", "notes": "notes", "gameMinutes": 0, "pace": 0, "teamStats": { "fieldGoals": { "pct": 0, "attempted": 0, "made": 0 }, "twoPointFieldGoals": { "pct": 0, "attempted": 0, "made": 0 }, "threePointFieldGoals": { "pct": 0, "attempted": 0, "made": 0 }, "freeThrows": { "pct": 0, "attempted": 0, "made": 0 }, "rebounds": { "total": 0, "defensive": 0, "offensive": 0 }, "turnovers": { "teamTotal": 0, "total": 0 }, "fouls": { "flagrant": 0, "technical": 0, "total": 0 }, "points": { "fastBreak": 0, "offTurnovers": 0, "inPaint": 0, "byPeriod": [ 0 ], "largestLead": 0, "total": 0 }, "fourFactors": { "freeThrowRate": 0, "offensiveReboundPct": 0, "turnoverRatio": 0, "effectiveFieldGoalPct": 0 }, "assists": 0, "blocks": 0, "steals": 0, "possessions": 0, "rating": 0, "trueShooting": 0, "gameScore": 0 }, "opponentStats": { "fieldGoals": { "pct": 0, "attempted": 0, "made": 0 }, "twoPointFieldGoals": { "pct": 0, "attempted": 0, "made": 0 }, "threePointFieldGoals": { "pct": 0, "attempted": 0, "made": 0 }, "freeThrows": { "pct": 0, "attempted": 0, "made": 0 }, "rebounds": { "total": 0, "defensive": 0, "offensive": 0 }, "turnovers": { "teamTotal": 0, "total": 0 }, "fouls": { "flagrant": 0, "technical": 0, "total": 0 }, "points": { "fastBreak": 0, "offTurnovers": 0, "inPaint": 0, "byPeriod": [ 0 ], "largestLead": 0, "total": 0 }, "fourFactors": { "freeThrowRate": 0, "offensiveReboundPct": 0, "turnoverRatio": 0, "effectiveFieldGoalPct": 0 }, "assists": 0, "blocks": 0, "steals": 0, "possessions": 0, "rating": 0, "trueShooting": 0, "gameScore": 0 } } ]
json
application/json

GET
https://api.collegebasketballdata.com
/games/players
Bearer

Returns player box scores and advanced metrics for up to 1,000 games that match the filters, ordered by start date.

query Parameters

startDateRange
​string · date-time

Includes games starting at or after this ISO 8601 timestamp.

endDateRange
​string · date-time

Includes games starting at or before this ISO 8601 timestamp.

team
​string

Filters results to the specified team name.

conference
​string

Filters results to the specified conference abbreviation.

season
​number · double

Filters results to the specified season.

seasonType
​SeasonType · enum

Filters results to the specified season type.

Enum values:
postseason
preseason
regular
tournament
​string

Filters results to the specified tournament, such as NCAA or NIT.

Responses

200

Ok

​GameBoxScorePlayers[]
GameBoxScorePlayers
gameId
​integer · int32 · required
season
​integer · int32 · required
seasonLabel
​string · required
seasonType
​SeasonType · enum · required
Enum values:
postseason
preseason
regular
tournament
​string | null · required
startDate
​string · date-time · required
startTimeTbd
​boolean · required
teamId
​integer · int32 · required
team
​string · required
conference
​string | null · required
teamSeed
​integer | null · int32 · required
opponentId
​integer · int32 · required
opponent
​string · required
opponentConference
​string | null · required
opponentSeed
​integer | null · int32 · required
neutralSite
​boolean · required
isHome
​boolean · required
conferenceGame
​boolean · required
gameType
​string | null · required
notes
​string | null · required
gameMinutes
​number | null · double · required
gamePace
​number | null · double · required
​object[] · required
GET/games/players
curl https://api.collegebasketballdata.com/games/players \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "gameId": 0, "season": 0, "seasonLabel": "seasonLabel", "seasonType": "postseason", "tournament": "tournament", "startDate": "2024-08-25T15:00:00Z", "startTimeTbd": true, "teamId": 0, "team": "team", "conference": "conference", "teamSeed": 0, "opponentId": 0, "opponent": "opponent", "opponentConference": "opponentConference", "opponentSeed": 0, "neutralSite": true, "isHome": true, "conferenceGame": true, "gameType": "gameType", "notes": "notes", "gameMinutes": 0, "gamePace": 0, "players": [ { "rebounds": { "total": 0, "defensive": 0, "offensive": 0 }, "freeThrows": { "pct": 0, "attempted": 0, "made": 0 }, "threePointFieldGoals": { "pct": 0, "attempted": 0, "made": 0 }, "twoPointFieldGoals": { "pct": 0, "attempted": 0, "made": 0 }, "fieldGoals": { "pct": 0, "attempted": 0, "made": 0 }, "offensiveReboundPct": 0, "freeThrowRate": 0, "assistsTurnoverRatio": 0, "gameScore": 0, "trueShootingPct": 0, "effectiveFieldGoalPct": 0, "netRating": 0, "defensiveRating": 0, "offensiveRating": 0, "usage": 0, "blocks": 0, "steals": 0, "assists": 0, "fouls": 0, "turnovers": 0, "points": 0, "minutes": 0, "ejected": true, "starter": true, "position": "position", "name": "name", "athleteSourceId": "athleteSourceId", "athleteId": 0 } ] } ]
json
application/json

GET
https://api.collegebasketballdata.com
/scoreboard
Bearer

Returns live scoreboard data. This endpoint requires Patreon Tier 1 access or higher.

query Parameters

conference
​string

Filters results to the specified conference abbreviation.

Responses

200

Ok

​ScoreboardGame[]
ScoreboardGame
id
​integer · int32 · required
startDate
​string · date-time · required
startTimeTbd
​boolean · required
tv
​string | null · required
neutralSite
​boolean · required
conferenceGame
​boolean · required
status
​GameStatus · enum · required
Enum values:
scheduled
in_progress
final
postponed
cancelled
period
​integer | null · int32 · required
clock
​string | null · required
venue
​string | null · required
city
​string | null · required
state
​string | null · required
​object · required
​object · required
​object · required
GET/scoreboard
curl https://api.collegebasketballdata.com/scoreboard \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "id": 0, "startDate": "2024-08-25T15:00:00Z", "startTimeTbd": true, "tv": "tv", "neutralSite": true, "conferenceGame": true, "status": "scheduled", "period": 0, "clock": "clock", "venue": "venue", "city": "city", "state": "state", "homeTeam": { "lineScores": [ 0 ], "points": 0, "conferenceAbbreviation": "conferenceAbbreviation", "conference": "conference", "location": "location", "name": "name", "id": 0 }, "awayTeam": { "lineScores": [ 0 ], "points": 0, "conferenceAbbreviation": "conferenceAbbreviation", "conference": "conference", "location": "location", "name": "name", "id": 0 }, "betting": { "awayMoneyline": 0, "homeMoneyline": 0, "overUnder": 0, "spread": 0 } } ]
json
application/json

Plays