--- title: "GET /games/{gameId}/preview" method: GET path: "/games/{gameId}/preview" tags: ["games"] --- # GET /games/{gameId}/preview `GET /games/{gameId}/preview` Returns 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 - `gameId` integer, required ## Response `200` Ok - GamePreview - `assembledAt` string, date-time, required - `game` GamePreviewMetadata, required - `id` integer, required - `season` integer, required - `week` integer, required - `seasonType` union, required - 'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason' - 'preseason' - `startDate` string, date-time, nullable, required - `startTimeTBD` boolean, nullable, required - `status` 'scheduled' | 'in_progress' | 'completed', required - `statusCheckedAt` string, date-time, required - `neutralSite` boolean, required - `conferenceGame` boolean, nullable, required - `venue` PreviewVenue, required - `id` integer, required - `name` string, nullable, required - `city` string, nullable, required - `state` string, nullable, required - `homeTeam` PreviewTeamIdentity, required - `id` integer, required - `name` string, required - `conference` string, nullable, required - `conferenceAbbreviation` string, nullable, required - `classification` 'fbs' | 'fcs' | 'ii' | 'ii/iii' | 'iii', required - `points` integer, nullable, required - `awayTeam` PreviewTeamIdentity, required - `id` integer, required - `name` string, required - `conference` string, nullable, required - `conferenceAbbreviation` string, nullable, required - `classification` 'fbs' | 'fcs' | 'ii' | 'ii/iii' | 'iii', required - `points` integer, nullable, required - `playoff` GamePlayoff, required - `competition` 'cfp', required - `format` string, required - `round` 'first_round' | 'quarterfinal' | 'semifinal' | 'championship', required - `roundName` string, required - `bracketSlot` string, required - `homeSeed` integer, nullable, required - `awaySeed` integer, nullable, required - `bowlName` string, nullable, required - `availability` 'pregame' | 'metadata_only', required - `reason` 'game_started' | 'game_completed' | 'kickoff_reached' | 'kickoff_unknown' | 'null', nullable, required - `analysis` FreePreviewAnalysis, required - `broadcasts` PreviewSectionPreviewBroadcastArray, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` PreviewBroadcast[], nullable, required - `mediaType` 'tv' | 'radio' | 'web' | 'ppv' | 'mobile', required - `outlet` string, required - `odds` PreviewSectionSelectedOdds, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` SelectedOdds, required - `providerId` integer, required - `provider` 'DraftKings' | 'Bovada', required - `spread` number, double, nullable, required — Home-relative spread; negative favors home. - `overUnder` number, double, nullable, required - `homeMoneyline` number, double, nullable, required - `awayMoneyline` number, double, nullable, required - `home` FreePreviewTeam, required - `teamId` integer, required - `season` integer, required - `record` PreviewSectionTeamSeasonOverviewAtRecord, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` object, nullable, required - `ties` integer, required - `losses` integer, required - `wins` integer, required - `games` integer, required - `ratings` PreviewSectionTeamSeasonOverviewAtRatings, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` object, nullable, required - `sp` object, nullable, required - `specialTeams` TeamSeasonRankedRating, required - … - `defense` TeamSeasonRankedRating, required - … - `offense` TeamSeasonRankedRating, required - … - `overall` TeamSeasonRankedRating, required - … - `srs` TeamSeasonRankedRating, required - `rating` number, double, nullable, required — Rating/efficiency rounded to two decimal places. - `rank` integer, nullable, required — Competition rank within the requested season and division, using unrounded values. - `elo` number, double, nullable, required — Latest available postgame Elo from a completed game in this season. - `core` object, nullable, required - `defense` TeamSeasonRankedRating, required - … - `offense` TeamSeasonRankedRating, required - … - `overall` TeamSeasonRankedRating, required - … - `fpi` object, nullable, required — FPI efficiencies (higher is better for all four), not the FPI points rating. - `specialTeams` TeamSeasonRankedRating, required - … - `defense` TeamSeasonRankedRating, required - … - `offense` TeamSeasonRankedRating, required - … - `overall` TeamSeasonRankedRating, required - … - `statistics` PreviewSectionPreviewTeamStatistics, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` PreviewTeamStatistics, required - `season` integer, required - `isPreviousSeason` boolean, required - `advanced` TeamSeasonAdvancedStats, required - `season` integer, required - `team` string, required - `conference` string, required - `offense` object, required - … - `defense` object, required - … - `passing` TeamPassingSeason, required - `season` integer, required - `team` string, required - `conference` string, nullable, required - `offense` PassingProduction, required — Defense reports opponent production allowed without inverting PPA signs. - … - `defense` PassingProduction, required — Defense reports opponent production allowed without inverting PPA signs. - … - `rushing` TeamRushingSeason, required - `season` integer, required - `team` string, required - `conference` string, nullable, required - `offense` TeamRushingProduction, required - … - `defense` TeamRushingProduction, required - … - `keyPlayers` PreviewKeyPlayers, required - `season` integer, required - `ppa` PlayerSourceAvailability, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required - `usage` PlayerSourceAvailability, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required - `passing` PreviewSectionPreviewKeyPlayerArray, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` PreviewKeyPlayer[], nullable, required - `athleteId` string, required - `name` string, nullable, required - `position` string, nullable, required - `usage` number, double, nullable, required — Pass/rush involvement, not receiving target share. - `averagePPA` number, double, nullable, required - `totalPPA` number, double, nullable, required - `rushing` PreviewSectionPreviewKeyPlayerArray, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` PreviewKeyPlayer[], nullable, required - `athleteId` string, required - `name` string, nullable, required - `position` string, nullable, required - `usage` number, double, nullable, required — Pass/rush involvement, not receiving target share. - `averagePPA` number, double, nullable, required - `totalPPA` number, double, nullable, required - `receiving` PreviewSectionPreviewKeyPlayerArray, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` PreviewKeyPlayer[], nullable, required - `athleteId` string, required - `name` string, nullable, required - `position` string, nullable, required - `usage` number, double, nullable, required — Pass/rush involvement, not receiving target share. - `averagePPA` number, double, nullable, required - `totalPPA` number, double, nullable, required - `recentResults` PreviewSectionRecentResultArray, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` RecentResult[], nullable, required - `gameId` integer, required - `season` integer, required - `startDate` string, date-time, required - `opponent` object, required - `name` string, required - `id` number, double, required - `homeAway` 'home' | 'away', required - `neutralSite` boolean, required - `venue` PreviewVenue, required - `id` integer, required - `name` string, nullable, required - `city` string, nullable, required - `state` string, nullable, required - `teamPoints` integer, nullable, required - `opponentPoints` integer, nullable, required - `result` 'win' | 'loss' | 'tie' | 'unknown', required - `away` FreePreviewTeam, required - `teamId` integer, required - `season` integer, required - `record` PreviewSectionTeamSeasonOverviewAtRecord, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` object, nullable, required - `ties` integer, required - `losses` integer, required - `wins` integer, required - `games` integer, required - `ratings` PreviewSectionTeamSeasonOverviewAtRatings, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` object, nullable, required - `sp` object, nullable, required - `specialTeams` TeamSeasonRankedRating, required - … - `defense` TeamSeasonRankedRating, required - … - `offense` TeamSeasonRankedRating, required - … - `overall` TeamSeasonRankedRating, required - … - `srs` TeamSeasonRankedRating, required - `rating` number, double, nullable, required — Rating/efficiency rounded to two decimal places. - `rank` integer, nullable, required — Competition rank within the requested season and division, using unrounded values. - `elo` number, double, nullable, required — Latest available postgame Elo from a completed game in this season. - `core` object, nullable, required - `defense` TeamSeasonRankedRating, required - … - `offense` TeamSeasonRankedRating, required - … - `overall` TeamSeasonRankedRating, required - … - `fpi` object, nullable, required — FPI efficiencies (higher is better for all four), not the FPI points rating. - `specialTeams` TeamSeasonRankedRating, required - … - `defense` TeamSeasonRankedRating, required - … - `offense` TeamSeasonRankedRating, required - … - `overall` TeamSeasonRankedRating, required - … - `statistics` PreviewSectionPreviewTeamStatistics, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` PreviewTeamStatistics, required - `season` integer, required - `isPreviousSeason` boolean, required - `advanced` TeamSeasonAdvancedStats, required - `season` integer, required - `team` string, required - `conference` string, required - `offense` object, required - … - `defense` object, required - … - `passing` TeamPassingSeason, required - `season` integer, required - `team` string, required - `conference` string, nullable, required - `offense` PassingProduction, required — Defense reports opponent production allowed without inverting PPA signs. - … - `defense` PassingProduction, required — Defense reports opponent production allowed without inverting PPA signs. - … - `rushing` TeamRushingSeason, required - `season` integer, required - `team` string, required - `conference` string, nullable, required - `offense` TeamRushingProduction, required - … - `defense` TeamRushingProduction, required - … - `keyPlayers` PreviewKeyPlayers, required - `season` integer, required - `ppa` PlayerSourceAvailability, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required - `usage` PlayerSourceAvailability, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required - `passing` PreviewSectionPreviewKeyPlayerArray, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` PreviewKeyPlayer[], nullable, required - `athleteId` string, required - `name` string, nullable, required - `position` string, nullable, required - `usage` number, double, nullable, required — Pass/rush involvement, not receiving target share. - `averagePPA` number, double, nullable, required - `totalPPA` number, double, nullable, required - `rushing` PreviewSectionPreviewKeyPlayerArray, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` PreviewKeyPlayer[], nullable, required - `athleteId` string, required - `name` string, nullable, required - `position` string, nullable, required - `usage` number, double, nullable, required — Pass/rush involvement, not receiving target share. - `averagePPA` number, double, nullable, required - `totalPPA` number, double, nullable, required - `receiving` PreviewSectionPreviewKeyPlayerArray, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` PreviewKeyPlayer[], nullable, required - `athleteId` string, required - `name` string, nullable, required - `position` string, nullable, required - `usage` number, double, nullable, required — Pass/rush involvement, not receiving target share. - `averagePPA` number, double, nullable, required - `totalPPA` number, double, nullable, required - `recentResults` PreviewSectionRecentResultArray, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` RecentResult[], nullable, required - `gameId` integer, required - `season` integer, required - `startDate` string, date-time, required - `opponent` object, required - `name` string, required - `id` number, double, required - `homeAway` 'home' | 'away', required - `neutralSite` boolean, required - `venue` PreviewVenue, required - `id` integer, required - `name` string, nullable, required - `city` string, nullable, required - `state` string, nullable, required - `teamPoints` integer, nullable, required - `opponentPoints` integer, nullable, required - `result` 'win' | 'loss' | 'tie' | 'unknown', required - `series` PreviewSectionSeriesHistory, required - `status` 'available' | 'no_data' | 'unavailable', required - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required - `assembledAt` string, date-time, required - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff. - `data` SeriesHistory, required - `homeTeamId` integer, required - `awayTeamId` integer, required - `meetings` integer, required - `knownResults` integer, required - `unknownResults` integer, required - `homeWins` integer, required - `awayWins` integer, required - `ties` integer, required - `firstSeason` integer, nullable, required - `lastSeason` integer, nullable, required - `latestMeeting` SeriesMeeting, required - `gameId` integer, required - `season` integer, required - `startDate` string, date-time, required - `homeTeamId` integer, required - `homeTeam` string, required - `awayTeamId` integer, required - `awayTeam` string, required - `neutralSite` boolean, required - `venue` PreviewVenue, required - `id` integer, required - `name` string, nullable, required - `city` string, nullable, required - `state` string, nullable, required - `homePoints` integer, nullable, required - `awayPoints` integer, nullable, required - `winnerTeamId` integer, nullable, required - `result` 'win' | 'tie' | 'unknown', required - `streak` object, nullable, required - `wins` number, double, required - `teamId` number, double, required - `recentMeetings` SeriesMeeting[], required - `gameId` integer, required - `season` integer, required - `startDate` string, date-time, required - `homeTeamId` integer, required - `homeTeam` string, required - `awayTeamId` integer, required - `awayTeam` string, required - `neutralSite` boolean, required - `venue` PreviewVenue, required - `id` integer, required - `name` string, nullable, required - `city` string, nullable, required - `state` string, nullable, required - `homePoints` integer, nullable, required - `awayPoints` integer, nullable, required - `winnerTeamId` integer, nullable, required - `result` 'win' | 'tie' | 'unknown', required ## Other responses - `400` — Validation error - `401` — Unauthorized - `404` - `503` ## Changes - **2026-09-27** `a34b9a28cc81` — 1 info - endpoint added [Change history](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/changes/games/:gameId/preview/get.md) --- [API](https://skmtc.dev/collegefootballdata/apis/college-football-data-api.md) · [All operations](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/revisions/a34b9a28cc81?raw)