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 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