Docs
Coverage MatrixDocumentationRelease LogLog In

NCAAFB Change Log

Find all updates to the NCAA Football v7 API and its documentation

Team Profile Enhancements

Release DateFeeds AffectedBenefit
09/20/2023League Hierarchy
Team Roster
Added several data points to team profiles.

New data includes:
- Year Founded
- Team Mascot
- Team Nicknames
- Fight Song
- Championships Won
- Conference Titles
- Division Titles
- Playoff Appearances
<team id="a2ee495d-37c7-45ac-ac3d-d3a492a219c1" name="Hawkeyes" market="Iowa" alias="IOW" 
      subdivision="BIG-TEN-WEST" founded="1847" mascot="Herky the Hawk" fight_song="Iowa Fight Song" 
      championships_won="1" conference_titles="12" playoff_appearances="0">
{
    "id": "a2ee495d-37c7-45ac-ac3d-d3a492a219c1",
    "name": "Hawkeyes",
    "market": "Iowa",
    "alias": "IOW",
    "subdivision": "BIG-TEN-WEST",
    "founded": 1847,
    "mascot": "Herky the Hawk",
    "fight_song": "Iowa Fight Song",
    "championships_won": 1,
    "conference_titles": 12,
    "playoff_appearances": 0,
    "franchise": {
        "id": "a2ee495d-37c7-45ac-ac3d-d3a492a219c1",
        "name": "Hawkeyes"
    },

Subdivision Standings

Release DateFeeds AffectedBenefit
08/24/2023Postgame StandingsAdded subdivision rank to the Postgame Standings endpoint, where applicable.

NCAA teams will now have a Conference (ex. FBS), Division (ex. Big Ten), and Subdivision (ex. Big Ten West) rank for season standings.
<team id="a2ee495d-37c7-45ac-ac3d-d3a492a219c1" name="Hawkeyes" market="Iowa" alias="IOW" wins="8" losses="5" ties="0" win_pct="0.615" points_for="230" points_against="173" subdivision="BIG-TEN-WEST">
    <rank conference="6" division="50" subdivision="3"/>
"conferences": [
    {
        "id": "cddff7c9-65e1-4fe0-b052-87fd4213fbfe",
        "name": "Big Ten",
        "alias": "BIG-TEN",
        "teams": [
            {
                "id": "fa0eb091-8e35-49c7-b00f-269794a99a61",
                "name": "Hoosiers",
                "market": "Indiana",
                "alias": "IU",
                "subdivision": "BIG-TEN-EAST",
                "rank": {
                    "conference": 12,
                    "division": 109,
                    "subdivision": 6
            },
    },

Enhanced Simulations

Release DateFeeds AffectedBenefit
08/08/2023Game Boxscore
Game Roster
Game Statistics
Play-by-Play
We are excited to introduce a new way to test our NFL and NCAA Football APIs with our latest simulation solution, providing a way to simulate our game feeds. This new solution will allow you to select from a library of games and replay games on your schedule. We are introducing this solution first with our NFL and NCAA Football APIs and plan to add other sports to our library.

Key highlights of our Football Simulations:
  • Select a game to simulate from a library of our recorded games.
  • Select the game feed(s) you are interested in playing back.
  • Start your session on your schedule—no more waiting for simulated games to start at a predefined time.
  • Playback the latest version of the API in natural time.
  • No API key is necessary to use the simulations.
  • We have 50 NFL and 20 NCAA Football games available from the 2022 football seasons. We will continue to add games to the library with 2023 games.
  • RESTful game endpoints available – Game Box Score, Play-by-Play, Statistics, and Rosters.
  • Push feeds are not supported right now.
Links:
  • https://developer.sportradar.com/football/reference/nfl-simulations
  • https://developer.sportradar.com/football/reference/ncaafb-simulations

In-Game Player Status

Release DateFeeds AffectedBenefit
07/28/2023Game RosterAdded support for in-game player status updates. This will provide real-time updates due to injuries, benchings, and other status changes.

in_game_status will be present for each player in the Game Roster endpoint.

List of supported in-game statuses:
  • active
  • probable
  • questionable
  • doubtful
  • out
  • benched
  • unknown

'Suspended' Game Status

Release DateFeeds AffectedBenefit
07/28/2023Current Season Schedule
Current Week Schedule
Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Season Schedule
Weekly Schedule
Push Events
Added “suspended” as a valid game status.

suspended = The game has been suspended and will be rescheduled in the future, continuing where they left off. The game ID will remain the same.

Jersey Number Support

Release DateFeeds AffectedBenefit
07/28/2023Daily Change Log
Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Player Profile
Seasonal Statistics
Team Roster
Push Events
Push Statistics
Adjusted logic to account for players without jersey numbers.

Players are no longer required to have a jersey number (player.jersey) present. Previously, players without a number were given 0.

Current Season and Current Week Endpoints

Release DateFeeds AffectedBenefit
07/18/2023Current Season Schedule
Current Week Schedule
Added two new endpoints: Current Season Schedule and Current Week Schedule.

Request these endpoints during an active season to retrieve the current week and/or season schedule information.

Comprehensive Drive Data

Release DateFeeds AffectedBenefit
05/16/2023Play-by-PlayAdded several data points to drives within the Play-by-Play endpoint.

New data points include:
  • team_sequence (the team's drive number)
  • start_clock (start time of a drive)
  • end_clock (end time of a drive)
  • first_drive_yardline (starting yardline of the first play of a drive, 1-99 scale)
  • last_drive_yardline (starting yardline of the last play of a drive, 1-99 scale)
  • net_yards (yards gained minus penalty yards)
  • pat_successful (whether there was a successful point after attempt on a drive)
  • pat_points_attempted (whether a PAT was attempted)
  • offensive_team - points (indicates how many points the offensive team scored on a drive)
  • offensive_team - id (indicates the offensive team on a drive)
  • defensive_team - points (indicates how many points the defensive team scored on a drive)
  • defensive_team - id (indicates the defensive team on a drive)

Conference Games Support

Release DateFeeds AffectedBenefit
05/16/2023Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Season Schedule
Weekly Schedule
Included a Boolean value (conference_game) for all game and schedule endpoints.

When true, this will indicate a game is a conference matchup.

Fourth Down Stops & Three and Outs Forced

Release DateFeeds AffectedBenefit
09/09/2022Game Statistics
Seasonal Statistics
Push Statistics
Added data to support defensive fourth down stops and three and outs forced on a game and season level.

This new team stat will be available going forward in Game Statistics, Seasonal Statistics, and Push Statistics feeds.

First Down Statistics

Release DateFeeds AffectedBenefit
08/30/2022Game Statistics
Player Profile
Seasonal Statistics
Push Statistics
Added player first downs to rushing, passing, and receiving stat categories.

Interception for a TD Attribute

Release DateFeeds AffectedBenefit
08/30/2022Game Boxscore
Game Statistics
Play-by-Play
Player Profile
Seasonal Statistics
Push Events
Push Statistics
Added an interception touchdown attribute to quarterback passing statistics. With this update users can now credit a 'pick six' to the quarterback at the game and season level.

Drive Start/End Reasons

Release DateFeeds AffectedBenefit
08/15/2022Game Boxscore
Play-by-Play
Push Events
Added support for missing drive reasons in the play-by-play data. This improvement includes Muffed Punt (start reason), Muffed Kickoff (start reason), and Missed FG (end reason).

Playoff Game Attribute

Release DateFeeds AffectedBenefit
08/15/2022Daily Change Log
Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Player Profile
Seasonal Statistics
Team Roster
Push Events
Push Statistics
Added a game playoff type attribute to all game endpoints. This will help to distinguish between FCS Playoff and College Football Playoff rounds.

Additional Player Positions

Release DateFeeds AffectedBenefit
08/15/2022Daily Change Log
Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Player Profile
Seasonal Statistics
Team Roster
Push Events
Push Statistics
Added support for three new positions: Athlete, Kicker/Punter, and Defensive Lineman.

Game Duration Data Point

Release DateFeeds AffectedBenefit
08/15/2022Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Season Schedule
Weekly Schedule
Push Events
Push Statistics
Added a game duration (length of the game in H:MM) value to all game-related endpoints.

New Simulations

Release DateFeeds AffectedBenefit
08/03/2022All Simulation EndpointsAdded simulated games, running every weekday from August 4th through August 26th. These sims give you the opportunity to test your code against a simulation of live data being entered before the season starts.

Initial Release

Release DateFeeds AffectedBenefit
07/07/2021AllInitial release for NCAA Men's Football v7.