Season Schedule

Time	Status	User Agent
Retrieving recent requests…

⏱️
Update Frequency
TTL / Cache:

10 minutes when season includes active games (games in non-closed status)

4 hours when no active games

Data Updates: Schedule info updates in realtime as changes are made

📘
Loading Schedules
Learn how to use the Season Schedule to load any season's full slate and locate game IDs in our Schedules integration scenario.

Data Points

Boxscore

Attribute	Parent Element	Type	Description
`attendance`	`game`	Integer	Attendance of a game ex. `73242`
`away_points`	`scoring`	Integer	Away team total points
`away_points`	`scoring` - `quarter`	Integer	Away team points in a quarter
`away_points`	`scoring` - `overtime`	Integer	Away team points in overtime
`home_points`	`scoring`	Integer	Home team total points
`home_points`	`scoring` - `quarter`	Integer	Home team points in a quarter
`home_points`	`scoring` - `overtime`	Integer	Home team points in overtime
`id`	`scoring` - `overtime`	GUID	Unique ID of overtime ex. `574d514d-369e-436f-9487-7007dc4bd785`
`number`	`scoring` - `overtime`	Integer	Overtime number
`sequence`	`scoring` - `overtime`	Integer	Period sequence number (The first overtime sequence would be `5`)
`id`	`scoring` - `quarter`	GUID	Unique ID of a quarter ex. `fffae31f-d810-483f-be86-b7db718dd175`
`number`	`scoring` - `quarter`	Integer	Quarter number
`sequence`	`scoring` - `quarter`	Integer	Period sequence number

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`
`name`	`away`	String	Away team name ex. `Horned Frogs`
`cable`	`broadcast`	String	Number of a game's broadcast cable station ex. `822`
`internet`	`broadcast`	String	Name of a game's internet stream ex. `ESPN+`
`network`	`broadcast`	String	Name of a game's broadcast network ex. `Amazon Prime Video`
`radio`	`broadcast`	String	Name of a game's radio station ex. `Sirius 134, XM 231`
`satellite`	`broadcast`	String	Name of a game's broadcast satellite station ex. `ESPN Ocho`
`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_number`	`away`	Integer	Sequential game number for the away team in a season
`game_number`	`home`	Integer	Sequential game number for the home team in a season
`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`
`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
`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`
`sr_id`	`game`	String	Unique Sportradar ID of a game ex. `sr:match:38354639`
`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`
`condition`	`weather`	String	Weather condition for a game ex. `Partly cloudy`, `Clear`, `Light Rain, Mist` Click here for more info on weather condition values
`humidity`	`weather`	Byte	Humidity conditions for a game ex. `44`
`temp`	`weather`	Byte	Temperature of a game in Fahrenheit ex. `57`
`direction`	`wind`	String	Wind direction for a game ex. `N`
`speed`	`wind`	Byte	Wind speed for a game in MPH
`id`	`deleted_games` - `game`	String	Unique ID of a deleted game `791e392f-1cc7-485c-bb95-026ac2cc31d1`

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`

League

Attribute	Parent Element	Type	Description
`alias`	`bye_week` - `team`	String	Bye team alias ex. `NTX` (North Texas)
`id`	`bye_week` - `team`	GUID	Unique ID of the bye team ex. `2a828de7-53d6-4a35-9f55-9aaa226956ed`
`name`	`bye_week` - `team`	String	Bye team name ex. `Mean Green`
`id`	`season`	GUID	Unique ID of a season ex. `ff53e5e4-10ef-4842-a0b7-b489956fa07e`
`name`	`season`	String	Name of the season `REG`
`type`	`season`	String	Type of the season `REG`
`year`	`season`	Integer	Year of the season
`id`	`week`	GUID	Unique week ID ex. `c5b272b0-388f-496d-ab6f-0a341b0a116b`
`sequence`	`week`	Integer	Week sequence number
`title`	`week`	String	Week title ex. `10`

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`
`lat`	`venue` - `location`	Decimal	Latitude of a venue ex. `41.6587`
`lng`	`venue` - `location`	Decimal	Longitude of a venue ex. `-91.5511`
`id`	`venue`	GUID	Unique ID of a venue ex. `967ef86b-d0de-49b7-8984-61f95104d30d`
`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`

Update Frequency

Loading Schedules

Data Points

200200