Sign in
games

Returns historical game data.

get/games

Query parameters

yearinteger

Season year. Required unless id is specified.

weekinteger

Week number.

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

Season type.

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

Division classification.

teamstring

Team name on either side of the game.

homestring

Home team name.

awaystring

Away team name.

conferencestring

Conference of either team.

idinteger

Game ID. When specified, returns data for that game.

competition'cfp'

Playoff competition.

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

Playoff round. 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' | 'ii/iii' | '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' | 'ii/iii' | '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

Changes

Changed in 2 of the 14 revisions of this API.25

  • 2753e757620d21See the full diff
    • ●

      added the new ii/iii enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ●

      added the new ii/iii enum value to the ///// response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value ii/iii to the query request parameter classification

      request-parameter-enum-value-added

  • 24c9bf0176164See the full diff
    • ○

      added the new optional query request parameter competition

      new-optional-request-parameter

    • ○

      added the new optional query request parameter round

      new-optional-request-parameter

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the required property / to the response with the status

      response-required-property-added