Sign in

v4

latestOpenAPI 3.0.0MIT2026-07-3171143160.0 KB
games

Retrieves historical game data

get/games

Query parameters

yearinteger

Required year filter (except when id is specified)

weekinteger

Optional week filter

seasonType'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason'

Optional season type filter

classification'fbs' | 'fcs' | 'ii' | 'iii'

Optional division classification filter

teamstring

Optional team filter

homestring

Optional home team filter

awaystring

Optional away team filter

conferencestring

Optional conference filter

idinteger

Game id filter to retrieve a single game

competition'cfp'

Optional playoff competition filter

round'first_round' | 'quarterfinal' | 'semifinal' | 'championship'

Optional playoff round filter; requires competition

Response

Ok

idinteger required
seasoninteger required
weekinteger required
seasonType'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason' required
startDatestring date-time required
startTimeTBDboolean required
completedboolean required
neutralSiteboolean required
conferenceGameboolean required
attendanceinteger nullable required
venueIdinteger nullable required
venuestring nullable required
homeIdinteger required
homeTeamstring required
homeConferencestring nullable required
homeClassification'fbs' | 'fcs' | 'ii' | 'iii' required
homePointsinteger nullable required
homeLineScoresnumber[] nullable required
homePostgameWinProbabilitynumber double nullable required
homePregameElointeger nullable required
homePostgameElointeger nullable required
awayIdinteger required
awayTeamstring required
awayConferencestring nullable required
awayClassification'fbs' | 'fcs' | 'ii' | 'iii' required
awayPointsinteger nullable required
awayLineScoresnumber[] nullable required
awayPostgameWinProbabilitynumber double nullable required
awayPregameElointeger nullable required
awayPostgameElointeger nullable required
excitementIndexnumber double nullable required
highlightsstring nullable required
notesstring nullable required