Game schedules, results, box scores, media, and weather.
Returns historical game data.
query Parameters
yearSeason year. Required unless id is specified.
weekWeek number.
seasonTypeSeason type.
classificationDivision classification.
teamTeam name on either side of the game.
homeHome team name.
awayAway team name.
conferenceConference of either team.
idGame ID. When specified, returns data for that game.
competitionPlayoff competition.
roundPlayoff round. Requires competition.
Responses
Ok
idseasonweekseasonTypestartDatestartTimeTBDcompletedneutralSiteconferenceGameattendancevenueIdvenuehomeIdhomeTeamhomeConferencehomeClassificationhomePointshomeLineScoreshomePostgameWinProbabilityhomePregameElohomePostgameEloawayIdawayTeamawayConferenceawayClassificationawayPointsawayLineScoresawayPostgameWinProbabilityawayPregameEloawayPostgameEloexcitementIndexhighlightsnotesReturns team box score statistics by game.
query Parameters
yearSeason year. Required unless id is specified.
weekWeek number. One of week, team, or conference is required
when filtering by year.
teamTeam name. One of week, team, or conference is required
when filtering by year.
conferenceConference name or abbreviation. One of week, team,
or conference is required when filtering by year.
classificationDivision classification.
seasonTypeSeason type.
idGame ID. When specified, returns statistics for that game.
Responses
Ok
idReturns player box score statistics by game.
query Parameters
yearSeason year. Required unless id is specified.
weekWeek number. One of week, team, or conference is required
when filtering by year.
teamTeam name. One of week, team, or conference is required
when filtering by year.
conferenceConference name or abbreviation. One of week, team,
or conference is required when filtering by year.
classificationDivision classification.
seasonTypeSeason type.
categoryPlayer statistical category.
idGame ID. When specified, returns statistics for that game.
Responses
Ok
idReturns broadcast and media information for games.
query Parameters
yearSeason year.
seasonTypeSeason type.
weekWeek number.
teamTeam name.
conferenceConference name or abbreviation.
mediaTypeMedia type.
classificationDivision classification.
Responses
Ok
idseasonweekseasonTypestartTimeisStartTimeTBDhomeTeamhomeConferenceawayTeamawayConferencemediaTypeoutletReturns historical and forecast weather data for games. Requires Patreon.
query Parameters
yearSeason year. Required unless gameId is specified.
seasonTypeSeason type.
weekWeek number.
teamTeam name.
conferenceConference name or abbreviation.
classificationDivision classification.
gameIdGame ID. When specified, returns weather for that game.
Responses
Ok
idseasonweekseasonTypestartTimegameIndoorshomeTeamhomeConferenceawayTeamawayConferencevenueIdvenuetemperaturedewPointhumidityprecipitationsnowfallwindDirectionwindSpeedpressureweatherConditionCodeweatherConditionReturns the active or next calendar slate, including completed games. Explicit windows require year, seasonType, and week together.
query Parameters
yearseasonTypeweekclassificationDivision of either participant. Defaults to fbs.
conferenceConference abbreviation of either participant.
Responses
Ok
assembledAtselectionReturns pregame team comparisons and key players. Analysis remains available until the game is completed. Team statistics may use the previous season; players and context stay in the game season.
path Parameters
gameIdResponses
Ok
assembledAtavailabilityreasonReturns stored adjusted team and player metrics until game completion. Requires Patreon Tier 1. Team metrics may use the previous season; players remain current-season.
path Parameters
gameIdResponses
Ok
assembledAtavailabilityreasonReturns historical team records by season.
query Parameters
yearSeason year. Required unless team is specified.
teamTeam name. Required unless year is specified.
conferenceConference name or abbreviation.
Responses
Ok
yearteamIdteamclassificationconferencedivisionexpectedWinsReturns the week-by-week season calendar.
query Parameters
yearSeason year.
Responses
Ok
seasonweekseasonTypestartDateendDatefirstGameStartlastGameStartReturns current scoreboard data.
query Parameters
classificationDivision classification. Defaults to fbs.
conferenceConference name or abbreviation.
Responses
Ok
idstartDatestartTimeTBDtvneutralSiteconferenceGamestatusperiodclocksituationpossessionlastPlay