Docs
Coverage MatrixDocumentationRelease LogLog InContact Us
Coverage MatrixDocumentationRelease LogLog InContact Us

NFL Change Log

Find all updates to the NFL v7 API and its documentation


TBD vs. TBD Support

Release DateFeeds AffectedBenefit
04/23/2024Current Season Schedule

Current Week Schedule

Season Schedule

Weekly Schedule		We are introducing support for Team TBD as a placeholder team.

This means you will now be able to obtain scheduled future games with known dates, even when one or both participants are yet to be determined.

See below for sample data.
<league xmlns="http://feed.elasticstats.com/schema/basketball/schedule-v5.0.xsd" id="4353138d-4c22-4396-95d8-5f587d2df25c" name="NBA" alias="NBA">
    <season-schedule id="851f97e4-c830-4590-88e9-e1286383148c" year="2023" type="PIT">
        <series id="4d8021ed-288b-4585-ad97-f82e6bc1ddf5" title="Eastern Conference - Play-in Round - #10 vs #9" round="1" start_date="2024-04-17" status="scheduled">
            <games>
                <game id="adafa13c-68d5-4127-bad0-48f46dc3485d" status="time-tbd" coverage="full" scheduled="2024-04-17T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          </home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          </away>
                </game>
            </games>
        </series>
        <series id="6171e123-afe8-4c67-b198-a33a29e7a572" title="Western Conference - Play-in Round - #8 vs #7" round="1" start_date="2024-04-16" status="scheduled">
            <games>
                <game id="34fbb07b-8985-45e8-b0e0-00a717230b90" status="time-tbd" coverage="full" scheduled="2024-04-16T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</away>
                </game>
            </games>
        </series>
        <series id="6f9c0c8d-0cc2-4c14-bc8c-5b0de7942b1a" title="Western Conference - Play-in Round - TBD vs TBD" round="1" start_date="2024-04-19" status="scheduled">
            <participant name="Western Conference - Play-in Round - #8 vs #7" record="0">
                <source id="6171e123-afe8-4c67-b198-a33a29e7a572" title="Western Conference - Play-in Round - #8 vs #7" round="1" outcome="loss"/>
            </participant>
            <participant name="Western Conference - Play-in Round - #10 vs #9" record="0">
                <source id="bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8" title="Western Conference - Play-in Round - #10 vs #9" round="1" outcome="win"/>
            </participant>
            <games>
                <game id="75da7f44-61fd-4590-b97a-074d863b20a7" status="time-tbd" coverage="full" scheduled="2024-04-19T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</away>
                </game>
            </games>
        </series>
        <series id="bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8" title="Western Conference - Play-in Round - #10 vs #9" round="1" start_date="2024-04-17" status="scheduled">
            <games>
                <game id="658de491-08be-4279-a8a7-6f98f1637e70" status="time-tbd" coverage="full" scheduled="2024-04-17T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</away>
                </game>
            </games>
        </series>
        <series id="ca09ddfd-fe0c-4914-8847-da15e23d251b" title="Eastern Conference - Play-in Round - #8 vs #7" round="1" start_date="2024-04-16" status="scheduled">
            <games>
                <game id="bd80d85f-28e4-4ae9-8dea-97b14951e8c2" status="time-tbd" coverage="full" scheduled="2024-04-16T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</away>
                </game>
            </games>
        </series>
        <series id="ec633fa3-3c1c-4560-98ac-5f75850d70e1" title="Eastern Conference - Play-in Round - TBD vs TBD" round="1" start_date="2024-04-19" status="scheduled">
            <participant name="Eastern Conference - Play-in Round - #8 vs #7" record="0">
                <source id="ca09ddfd-fe0c-4914-8847-da15e23d251b" title="Eastern Conference - Play-in Round - #8 vs #7" round="1" outcome="loss"/>
            </participant>
            <participant name="Eastern Conference - Play-in Round - #10 vs #9" record="0">
                <source id="4d8021ed-288b-4585-ad97-f82e6bc1ddf5" title="Eastern Conference - Play-in Round - #10 vs #9" round="1" outcome="win"/>
            </participant>
            <games>
                <game id="b1c9bbbe-feb8-43e8-8226-4df5f013c0ff" status="time-tbd" coverage="full" scheduled="2024-04-19T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
                    <time_zones/>
                    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</home>
                    <away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
          					</away>
                </game>
            </games>
        </series>
    </season-schedule>
</league>



{
    "league": {
        "id": "4353138d-4c22-4396-95d8-5f587d2df25c",
        "name": "NBA",
        "alias": "NBA"
    },
    "season": {
        "id": "851f97e4-c830-4590-88e9-e1286383148c",
        "year": 2023,
        "type": "PIT"
    },
    "series": [
        {
            "id": "4d8021ed-288b-4585-ad97-f82e6bc1ddf5",
            "title": "Eastern Conference - Play-in Round - #10 vs #9",
            "round": 1,
            "start_date": "2024-04-17",
            "status": "scheduled",
            "participants": [],
            "games": [
                {
                    "id": "adafa13c-68d5-4127-bad0-48f46dc3485d",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-17T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        },
        {
            "id": "6171e123-afe8-4c67-b198-a33a29e7a572",
            "title": "Western Conference - Play-in Round - #8 vs #7",
            "round": 1,
            "start_date": "2024-04-16",
            "status": "scheduled",
            "participants": [],
            "games": [
                {
                    "id": "34fbb07b-8985-45e8-b0e0-00a717230b90",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-16T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        },
        {
            "id": "6f9c0c8d-0cc2-4c14-bc8c-5b0de7942b1a",
            "title": "Western Conference - Play-in Round - TBD vs TBD",
            "round": 1,
            "start_date": "2024-04-19",
            "status": "scheduled",
            "participants": [
                {
                    "name": "Western Conference - Play-in Round - #8 vs #7",
                    "record": 0,
                    "source": {
                        "id": "6171e123-afe8-4c67-b198-a33a29e7a572",
                        "title": "Western Conference - Play-in Round - #8 vs #7",
                        "round": 1,
                        "outcome": "loss"
                    }
                },
                {
                    "name": "Western Conference - Play-in Round - #10 vs #9",
                    "record": 0,
                    "source": {
                        "id": "bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8",
                        "title": "Western Conference - Play-in Round - #10 vs #9",
                        "round": 1,
                        "outcome": "win"
                    }
                }
            ],
            "games": [
                {
                    "id": "75da7f44-61fd-4590-b97a-074d863b20a7",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-19T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        },
        {
            "id": "bf5f0c02-ba3e-4cbc-94e4-c3c1d5864ad8",
            "title": "Western Conference - Play-in Round - #10 vs #9",
            "round": 1,
            "start_date": "2024-04-17",
            "status": "scheduled",
            "participants": [],
            "games": [
                {
                    "id": "658de491-08be-4279-a8a7-6f98f1637e70",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-17T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        },
        {
            "id": "ca09ddfd-fe0c-4914-8847-da15e23d251b",
            "title": "Eastern Conference - Play-in Round - #8 vs #7",
            "round": 1,
            "start_date": "2024-04-16",
            "status": "scheduled",
            "participants": [],
            "games": [
                {
                    "id": "bd80d85f-28e4-4ae9-8dea-97b14951e8c2",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-16T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        },
        {
            "id": "ec633fa3-3c1c-4560-98ac-5f75850d70e1",
            "title": "Eastern Conference - Play-in Round - TBD vs TBD",
            "round": 1,
            "start_date": "2024-04-19",
            "status": "scheduled",
            "participants": [
                {
                    "name": "Eastern Conference - Play-in Round - #8 vs #7",
                    "record": 0,
                    "source": {
                        "id": "ca09ddfd-fe0c-4914-8847-da15e23d251b",
                        "title": "Eastern Conference - Play-in Round - #8 vs #7",
                        "round": 1,
                        "outcome": "loss"
                    }
                },
                {
                    "name": "Eastern Conference - Play-in Round - #10 vs #9",
                    "record": 0,
                    "source": {
                        "id": "4d8021ed-288b-4585-ad97-f82e6bc1ddf5",
                        "title": "Eastern Conference - Play-in Round - #10 vs #9",
                        "round": 1,
                        "outcome": "win"
                    }
                }
            ],
            "games": [
                {
                    "id": "b1c9bbbe-feb8-43e8-8226-4df5f013c0ff",
                    "status": "time-tbd",
                    "coverage": "full",
                    "scheduled": "2024-04-19T17:00:00+00:00",
                    "neutral_site": false,
                    "track_on_court": true,
                    "home": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    },
                    "away": {
                        "name": "Team TBD",
                        "alias": "TBD",
                        "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
                    }
                }
            ]
        }
    ]
}

'Reserve/Future' Player Status

Release DateFeeds AffectedBenefit
04/19/2024Player Profile

Team Profile

Team Roster		Added FRES (Reserve/Future) as a valid player status.

'Practice Squad' Player Status

Release DateFeeds AffectedBenefit
03/13/2024Player Profile

Team Profile

Team Roster		Added PRA_IR (Practice Squad Injured Reserve) as a valid player status.

Preseason Stats

Release DateFeeds AffectedBenefit
02/26/2024Player ProfileAdded preseason statistics to the Player Profile endpoint.

Team Profile Enhancements

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

New data includes:
- Year Founded
- Owner
- General Manager
- Team President
- Team Mascot
- Team Nicknames
- Fight Song
- Championships Won
- Championship Seasons
- Conference Titles
- Division Titles
- Playoff Appearances
<team id="0d855753-ea21-4953-89f9-0e20aff9eb73" name="Saints" market="New Orleans" alias="NO" 
      sr_id="sr:competitor:4425" founded="1967" owner="Gayle Benson" general_manager="Mickey Loomis" 
      president="Dennis Lauscha" mascot="Gumbo, Sir Saint" nicknames="The Black and Gold" 
      fight_song="When the Saints Go Marching In" championships_won="1" championship_seasons="2009" 
      conference_titles="1" division_titles="9" playoff_appearances="14">

{
    "id": "0d855753-ea21-4953-89f9-0e20aff9eb73",
    "name": "Saints",
    "market": "New Orleans",
    "alias": "NO",
    "sr_id": "sr:competitor:4425",
    "founded": 1967,
    "owner": "Gayle Benson",
    "general_manager": "Mickey Loomis",
    "president": "Dennis Lauscha",
    "mascot": "Gumbo, Sir Saint",
    "nicknames": "The Black and Gold",
    "fight_song": "When the Saints Go Marching In",
    "championships_won": 1,
    "championship_seasons": "2009",
    "conference_titles": 1,
    "division_titles": 9,
    "playoff_appearances": 14,
    "franchise": {
        "id": "bdf043f4-8199-4f76-92ea-5604cc53ad12",
        "name": "Saints",
        "alias": "NO"
    },

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

Player Experience

Release DateFeeds AffectedBenefit
07/28/2023Player Profile
Team Profile
Team Roster		Added experience for player profiles.

This new attribute will represent the number of years active in the NFL for a player.

'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
Push Pulse		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 Transactions
Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Player Profile
Seasonal Statistics
Team Profile
Team Roster
Weekly Depth Charts
Weekly Injuries
Push Events
Push Pulse
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.

Push Pulse Feed

Release DateFeeds AffectedBenefit
07/26/2023Push PulseAdded a new endpoint: Push Pulse

This Push feed provides real-time messages about on-field activity before, during, and after a play. Easily integrate it with our existing Push Events and Statistics feeds for more comprehensive coverage.

Events include:
  • Players approaching the line of scrimmage
  • Ball snap (play start)
  • End of play
  • Game clock status (start and stop)
  • Play event outcome
  • Updated game state info (possession, down, distance, and location)

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

First Down Statistics

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

Interception Return Statistic

Release DateFeeds AffectedUpdate
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.

Game Duration Added

Release DateFeeds AffectedUpdate
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 endpoints.

New Drive Start/End Reasons

Release DateFeeds AffectedUpdate
08/15/2022Game Boxscore
Play-by-Play
Push Events		Added support for the following drive start/end reasons: Muffed Punt (start), Muffed Kickoff (start), and Missed FG (end).

'Defensive Lineman' Position Added

Release DateFeeds AffectedUpdate
08/15/2022Daily Change Log
Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Player Profile
Seasonal Statistics
Team Rosters
Push Events
Push Statistics		Added support for a new position: Defensive Lineman.

Daily Transactions Endpoint

Release DateFeeds AffectedUpdate
07/18/2022Daily TransactionsAdded data in support of the new Daily Transactions endpoint. This provides information for all transactions added or edited during a given league-defined day.

Compensatory Draft Pick Support

Release DateFeeds AffectedUpdate
04/13/2022Draft Summary
Team Draft Summary
Trades
Push Draft Picks
Push Draft Trades		Added support for compensatory draft picks to all relevant Draft feeds.

Enhanced Standings Data

Release DateFeeds AffectedUpdate
12/14/2021Postgame StandingsAdded clinched status, strength of schedule, and strength of victory to the Postgame Standings feed. Included supported clinched values in FAQ.

© Sportradar AG, St. Gallen, Switzerland