⏱️
Update Frequency
TTL / Cache: 4 hours
Data Updates:

Schedule info updates in realtime as changes are made.

The initial playoff schedule (with TBD matchups) will be available shortly after the regular season schedule is released.

Teams advance to the next round on a 2-minute timer after the previous game moves to complete status.

Data Points

Game

Attribute	Parent Element	Type	Description
`alias`	`away`	String	Away team alias ex. `TCU` (Texas Christian University)
`id`	`away`	GUID	Unique ID of the away team ex. `a09e634d-39a8-4aa8-81a4-7337580a31f4`
`market`	`away`	String	Away team market name ex. `TCU`
`name`	`away`	String	Away team name ex. `Horned Frogs`
`conference_game`	`game`	Boolean	Signifies an in-Conference matchup ex. (SEC vs. SEC)
`coverage`	`game`	String	Coverage level of a game `full`, `extended_boxscore`
`duration`	`game`	String	Duration of a game ex. `2:52`
`entry_mode`	`game`	String	Type of data entry for the game `LDE` (Live Data Entry)
`game_type`	`game`	String	Type of game `regular`, `conference_championship`, `bowl`, `playoff`
`alias`	`home`	String	Home team alias ex. `UGA` (University of Georgia)
`id`	`home`	GUID	Unique ID of the home team ex. `2eef738d-c637-4b12-b8df-4b79efcce71e`
`market`	`home`	String	Home team market name ex. `Georgia`
`name`	`home`	String	Home team name ex. `Bulldogs`
`id`	`game`	GUID	Unique ID of a game ex. `c9686716-f48a-4667-996d-97639429d8c3`
`neutral_site`	`game`	Boolean	Signifies a game is held at a neutral site
`parent_id`	`game`	GUID	Parent ID of a game ex. `9c77e6a1-d2c6-483a-a01e-150797e94e7e`
`playoff_game_type`	`game`	String	Name of a playoff game type See our FAQ for a list of valid playoff game types
`parent_id`	`game`	GUID	Standard parent ID of a game. Use this ID to group events (like bowl games) across seasons.
`scheduled`	`game`	Date/Time	Scheduled date and time of a game ex. `2022-09-25T20:10:00+00:00`
`status`	`game`	String	Game status `scheduled`, `created`, `inprogress`, `halftime`, `complete`, `closed`, `cancelled`, `postponed`, `delayed`, `suspended`, `flex-schedule`, `time-tbd` See our NCAAFB FAQ for game status descriptions
`title`	`game`	String	Game title ex. `CFP National Championship`
`away`	`time_zones`	String	Time zone of the away team ex. `US/Pacific`
`home`	`time_zones`	String	Time zone of the home team ex. `US/Eastern`
`venue`	`time_zones`	String	Time zone of the venue ex. `US/Eastern`

League

Attribute	Parent Element	Type	Description
`alias`	`league`	String	Alias of a league ex. `NCAAFB`
`id`	`league`	GUID	Unique ID of a league ex. `26c1246a-2fc3-4b7e-8999-1685d3ab4676`
`name`	`league`	String	Name of a league ex. `NCAA Football`

Game (Previous Round)

Attribute	Parent Element	Type	Description
`name`	`game` - `away`	String	Away team full name. Team name will populate after the source game has ended. Prior to this, the field will populate the source game title. ex. `Hawkeyes` or `Orange Bowl - Semifinal (win)` (team unknown)
`alias`	`game` - `away`	String	Away team alias. Team alias will populate after the source game has ended. Prior to this, the field will populate the source game title. ex. `IOW` or `Orange Bowl - Semifinal (win)` (team unknown)
`name`	`game` - `home`	String	Home team full name. Team name will populate after the source game has ended. Prior to this, the field will populate the source game title. ex. `Hawkeyes` or `Orange Bowl - Semifinal (win)` (team unknown)
`alias`	`game` - `home`	String	Home team alias. Team alias will populate after the source game has ended. Prior to this, the field will populate the source game title. ex. `IOW` or `Orange Bowl - Semifinal (win)` (team unknown)
`coverage`	`game` - `away` / `home` - `source`	String	Coverage level of a previous (source) playoff matchup `full`, `extended_boxscore`
`id`	`game` - `away` / `home` - `source`	GUID	Unique game ID of the of a previous (source) playoff matchup ex. `11845229-fffb-4fb1-bab6-ec276fb56447`
`game_type`	`game` - `away` / `home` - `source`	String	Type of game of a previous (source) playoff matchup `regular`, `conference_championship`, `bowl`, `playoff`
`outcome`	`game` - `away` / `home` - `source`	String	Outcome of a previous (source) playoff matchup ex. `win`
`scheduled`	`game` - `away` / `home` - `source`	dateTime	Scheduled date and time of a previous (source) playoff matchup ex. `2023-03-21T23:00:00+00:00`
`status`	`game` - `away` / `home` - `source`	String	Game status of a previous (source) playoff matchup ex. `closed`
`title`	`game` - `away` / `home` - `source`	String	Game title of a previous (source) playoff matchup ex. `CFP National Championship`

Bracket & Round

Attribute	Parent Element	Type	Description
`id`	`round`	GUID	Unique ID of a round ex. `9d9f0022-5125-40b0-a5c0-5e97b3d122c5`
`sequence`	`round`	String	Sequential number of a round
`name`	`round`	String	Name of a round ex. `Semifinals` or `National Championship`

Tournament

Attribute	Parent Element	Type	Description
`status`	`tournament-schedule`	String	Status of a tournament ex. `scheduled`, `inprogress`, `closed`
`id`	`tournament-schedule`	GUID	Unique ID of a tournament ex. `77b49a1b-e3a0-4833-9ab0-799367dd97b1`
`location`	`tournament-schedule`	String	Location of a tournament ex. `Atlanta, GA, USA`
`name`	`tournament-schedule`	String	Name of a tournament ex. `College Football Playoff`

Venue

Attribute	Parent Element	Type	Description
`address`	`venue`	String	Address of a venue ex. `886 Stadium Drive`
`capacity`	`venue`	Integer	Capacity of a venue ex. `69250`
`city`	`venue`	String	City of a venue ex. `Iowa City`
`country`	`venue`	String	Country of a venue ex. `USA`
`id`	`venue`	GUID	Unique ID of a venue ex. `967ef86b-d0de-49b7-8984-61f95104d30d`
`lat`	`venue` - `location`	Decimal	Latitude of a venue ex. `41.6587`
`lng`	`venue` - `location`	Decimal	Longitude of a venue ex. `-91.5511`
`name`	`venue`	String	Name of a venue ex. `Kinnick Stadium`
`roof_type`	`venue`	String	Roof type of a venue `outdoor`, `dome`, `retractable_dome`
`state`	`venue`	String	State of a venue ex. `IA`
`surface`	`venue`	String	Surface type of a venue `turf`, `artificial`, `outdoor`
`zip`	`venue`	Integer	ZIP code of a venue ex. `52242`

200200