Find all updates to the NFL v5 API and its documentation
Push Statistics - Game Data
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 06/05/2024 | Push Statistics | We've added a number of game attributes to the Push Statistics feed. These attributes can also be found in the RESTful Game Statistics endpoint and include, but are not limited to: - Attendance - Remaining Challenges - Used Challenges - Remaining Timeouts - Used Timeouts - Game Clock - Game Duration - Home/Away Id - Home/Away Market - Home/Away Name - Home/Away SR Id - Weather Info - Season Id - Season Name - Season Type - Season Year - Week Id - Week Sequence - Week Title - Venue Info See below for sample data including the updated attributes. |
{
"payload":{
"player":{
"name":"Noah Gray",
"jersey":"83",
"id":"c97dfcb6-b999-476f-8487-f3848e92df17",
"position":"TE",
"sr_id":"sr:player:2197934"
},
"receiving":{
"receptions":2,
"targets":2,
"yards":22,
"avg_yards":11.0,
"longest":12,
"touchdowns":0,
"yards_after_catch":14,
"redzone_targets":0,
"air_yards":8,
"broken_tackles":0,
"dropped_passes":0,
"catchable_passes":0,
"yards_after_contact":5,
"firstdowns":1
}
},
"locale":"en",
"metadata":{
"league":"nfl",
"match":"sd:match:902a4753-72f9-4868-9d9b-193a5c41ea4d,sr:match:46791617",
"status":"closed",
"participant":"sd:player:c97dfcb6-b999-476f-8487-f3848e92df17,sr:player:2197934",
"locale":"en",
"operation":"update",
"version":"v7"
}
}{
"payload":{
"player":{
"name":"Tommy Townsend",
"jersey":"05",
"id":"edfc712a-54f7-4c34-a838-c50c14dbf7dc",
"position":"P",
"sr_id":"sr:player:2040157"
},
"punts":{
"attempts":5,
"yards":254,
"avg_yards":50.8,
"blocked":0,
"longest":62,
"touchbacks":0,
"inside_20":2,
"avg_net_yards":50.8,
"return_yards":0,
"net_yards":254,
"hang_time":25.048,
"avg_hang_time":5.01
}
},
"locale":"en",
"metadata":{
"league":"nfl",
"match":"sd:match:902a4753-72f9-4868-9d9b-193a5c41ea4d,sr:match:46791617",
"status":"closed",
"participant":"sd:player:edfc712a-54f7-4c34-a838-c50c14dbf7dc,sr:player:2040157",
"locale":"en",
"operation":"update",
"version":"v7"
}
}{
"payload":{
"name":"Chiefs",
"market":"Kansas City",
"alias":"KC",
"id":"902a4753-72f9-4868-9d9b-193a5c41ea4d",
"title":"Super Bowl LVIII",
"status":"closed",
"coverage":"full",
"neutral_site":true,
"game_type":"playoff",
"scheduled":"2024-02-11T23:30:00+00:00",
"attendance":61629,
"duration":"4:06",
"entry_mode":"LDE",
"wx_temp":54,
"wx_humidity":26,
"wx_wind_speed":6,
"wx_wind_direction":"NE",
"wx_condition":"Sunny",
"weather":"Sunny Temp: 54 F, Humidity: 26%, Wind: NE 6 mph",
"quarter":5,
"clock":"00:03",
"conference_game":false,
"sr_id":"sr:match:46791617",
"team":{
"name":"Chiefs",
"market":"Kansas City",
"alias":"KC",
"id":"6680d28d-d4d2-49f6-aace-5292d3ec02c2",
"sr_id":"sr:competitor:4422"
},
"summary":{
"possession_time":"36:26",
"avg_gain":5.8,
"safeties":0,
"turnovers":2,
"play_count":79,
"rush_plays":30,
"total_yards":455,
"fumbles":5,
"lost_fumbles":1,
"penalties":6,
"penalty_yards":55,
"return_yards":12,
"season":{
"id":"736474f0-adc5-11ee-b174-6f0e0e094ae8",
"year":2023,
"type":"PST",
"name":"PST"
},
"week":{
"id":"8ece04d3-ed37-4ac0-a66b-5c0a1fdf99f3",
"sequence":4,
"title":"4"
},
"venue":{
"id":"53d42601-5dfb-40a7-bd94-da2c1d3a75e4",
"name":"Allegiant Stadium",
"city":"Las Vegas",
"state":"NV",
"country":"USA",
"zip":"89118",
"address":"3333 Al Davis Way",
"capacity":65000,
"surface":"turf",
"roof_type":"dome",
"sr_id":"sr:venue:51543",
"location":{
"latitude":"36.090852",
"longitude":"-115.183339"
}
},
"home":{
"name":"Chiefs",
"market":"Kansas City",
"alias":"KC",
"used_timeouts":1,
"remaining_timeouts":1,
"used_challenges":0,
"remaining_challenges":2,
"id":"6680d28d-d4d2-49f6-aace-5292d3ec02c2",
"points":25,
"sr_id":"sr:competitor:4422",
"record":{
"wins":11,
"losses":6,
"ties":0
}
},
"away":{
"name":"49ers",
"market":"San Francisco",
"alias":"SF",
"used_timeouts":1,
"remaining_timeouts":1,
"used_challenges":0,
"remaining_challenges":2,
"id":"f0e724b0-4cbf-495a-be47-013907608da9",
"points":22,
"sr_id":"sr:competitor:4389",
"record":{
"wins":12,
"losses":5,
"ties":0
}
}
},
"rushing":{
"avg_yards":4.333,
"attempts":30,
"touchdowns":0,
"tlost":1,
"tlost_yards":-3,
"yards":130,
"longest":22,
"redzone_attempts":5,
"broken_tackles":2,
"kneel_downs":0,
"scrambles":6,
"yards_after_contact":38,
"firstdowns":9
},
"receiving":{
"targets":42,
"receptions":34,
"avg_yards":9.794,
"yards":333,
"touchdowns":2,
"yards_after_catch":184,
"longest":52,
"longest_touchdown":16,
"redzone_targets":6,
"air_yards":149,
"broken_tackles":2,
"dropped_passes":1,
"catchable_passes":1,
"yards_after_contact":41,
"firstdowns":15
},
"punts":{
"attempts":5,
"yards":254,
"net_yards":254,
"blocked":0,
"touchbacks":0,
"inside_20":2,
"return_yards":0,
"avg_net_yards":50.8,
"avg_yards":50.8,
"longest":62,
"hang_time":25.048,
"avg_hang_time":5.01
},
"punt_returns":{
"avg_yards":3.0,
"returns":4,
"yards":12,
"longest":7,
"touchdowns":0,
"faircatches":0
},
"penalties":{
"penalties":6,
"yards":55,
"firstdowns":3,
"def_penalties":4,
"def_penalty_yards":40,
"off_penalties":2,
"off_penalty_yards":15,
"sp_penalties":0,
"sp_penalty_yards":0
},
"passing":{
"attempts":46,
"completions":34,
"cmp_pct":73.913,
"interceptions":1,
"sack_yards":8,
"rating":99.3,
"touchdowns":2,
"avg_yards":6.633,
"sacks":3,
"longest":52,
"longest_touchdown":16,
"air_yards":149,
"redzone_attempts":6,
"throw_aways":4,
"defended_passes":1,
"dropped_passes":1,
"spikes":0,
"blitzes":7,
"hurries":2,
"knockdowns":4,
"pocket_time":126.62199999999999,
"avg_pocket_time":2.753,
"poor_throws":6,
"on_target_throws":35,
"batted_passes":0,
"firstdowns":15,
"int_touchdowns":0,
"net_yards":325,
"yards":333
},
"misc_returns":{
"returns":0,
"yards":0,
"touchdowns":0,
"blk_fg_touchdowns":0,
"blk_punt_touchdowns":0,
"fg_return_touchdowns":0,
"ez_rec_touchdowns":0,
"blk_fg_yards":0,
"blk_fg_returns":0,
"blk_punt_yards":0,
"blk_punt_returns":0,
"fg_return_yards":0,
"fg_return_returns":0
},
"kickoffs":{
"kickoffs":7,
"endzone":0,
"inside_20":0,
"return_yards":0,
"returned":0,
"touchbacks":7,
"yards":455,
"out_of_bounds":0,
"onside_attempts":0,
"onside_successes":0,
"squib_kicks":0,
"net_yards":280,
"longest":65,
"return_touchdowns":0
},
"kick_returns":{
"avg_yards":0.0,
"returns":0,
"yards":0,
"longest":0,
"touchdowns":0,
"faircatches":0
},
"int_returns":{
"avg_yards":0.0,
"returns":0,
"yards":0,
"touchdowns":0
},
"fumbles":{
"fumbles":5,
"lost_fumbles":1,
"own_rec":4,
"own_rec_yards":-10,
"opp_rec":2,
"opp_rec_yards":0,
"out_of_bounds":0,
"forced_fumbles":1,
"own_rec_tds":0,
"opp_rec_tds":0,
"ez_rec_tds":0
},
"field_goals":{
"attempts":4,
"made":4,
"blocked":0,
"yards":138,
"avg_yards":34.5,
"longest":57,
"attempts_19":0,
"attempts_29":3,
"attempts_39":0,
"attempts_49":0,
"attempts_50":1,
"made_19":0,
"made_29":3,
"made_39":0,
"made_49":0,
"made_50":1,
"missed":0
},
"extra_points":{
"kick_attempts":1,
"kick_blocked":0,
"kick_made":1,
"pass_conv_attempts":0,
"pass_conv_successes":0,
"rush_conv_attempts":0,
"rush_conv_successes":0,
"def_conv_attempts":0,
"def_conv_successes":0,
"missed":0,
"pass_conv_three_point_attempts":0,
"pass_conv_three_point_successes":0,
"rush_conv_three_point_attempts":0,
"rush_conv_three_point_successes":0,
"def_conv_three_point_attempts":0,
"def_conv_three_point_successes":0
},
"defense":{
"tackles":33,
"assists":41,
"combined":74,
"sacks":1.0,
"sack_yards":4.0,
"passes_defended":6,
"forced_fumbles":1,
"fumble_recoveries":1,
"qb_hits":11,
"tloss":4.0,
"tloss_yards":15.0,
"safeties":0,
"sp_tackles":1,
"sp_assists":0,
"sp_forced_fumbles":0,
"sp_fumble_recoveries":1,
"sp_blocks":1,
"misc_tackles":1,
"misc_assists":0,
"misc_forced_fumbles":0,
"misc_fumble_recoveries":0,
"def_targets":37,
"def_comps":24,
"blitzes":25,
"hurries":0,
"knockdowns":9,
"missed_tackles":8,
"batted_passes":2,
"three_and_outs_forced":3,
"fourth_down_stops":0,
"def_yards_against":276,
"field_goal_blocks":0,
"punt_blocks":0,
"extra_point_blocks":1,
"def_touchdowns_against":2,
"sp_opp_fumble_recoveries":0,
"sp_own_fumble_recoveries":0,
"number":0
},
"efficiency":{
"goaltogo":{
"attempts":3,
"successes":1,
"pct":33.333,
"fg_successes":1,
"td_successes":1
},
"redzone":{
"attempts":6,
"successes":2,
"pct":33.333,
"fg_successes":3,
"td_successes":2
},
"thirddown":{
"attempts":19,
"successes":9,
"pct":47.368
},
"fourthdown":{
"attempts":1,
"successes":1,
"pct":100.0
}
},
"first_downs":{
"pass":15,
"penalty":0,
"rush":9,
"total":24
},
"interceptions":{
"return_yards":0,
"returned":0,
"number":0
},
"touchdowns":{
"pass":2,
"rush":0,
"total_return":0,
"total":2,
"fumble_return":0,
"int_return":0,
"kick_return":0,
"punt_return":0,
"other":0
}
},
"locale":"en",
"metadata":{
"league":"nfl",
"match":"sd:match:902a4753-72f9-4868-9d9b-193a5c41ea4d,sr:match:46791617",
"status":"closed",
"participant":"sd:team:6680d28d-d4d2-49f6-aace-5292d3ec02c2,sr:competitor:4422",
"locale":"en",
"operation":"update",
"version":"v7"
}
}{
"payload":{
"player":{
"name":"Leo Chenal",
"jersey":"54",
"id":"c7929fb3-5437-42cc-a3c2-10b73ebb1fa0",
"position":"LB",
"sr_id":"sr:player:1695607"
},
"fumbles":{
"fumbles":0,
"lost_fumbles":0,
"own_rec":0,
"own_rec_yards":0,
"opp_rec":0,
"opp_rec_yards":0,
"out_of_bounds":0,
"forced_fumbles":1,
"own_rec_tds":0,
"opp_rec_tds":0,
"ez_rec_tds":0
},
"defense":{
"tackles":3,
"assists":3,
"combined":6,
"sacks":0.0,
"sack_yards":0.0,
"interceptions":0,
"passes_defended":0,
"forced_fumbles":1,
"fumble_recoveries":0,
"qb_hits":1,
"tloss":1.0,
"tloss_yards":8.0,
"safeties":0,
"sp_tackles":0,
"sp_assists":0,
"sp_forced_fumbles":0,
"sp_fumble_recoveries":0,
"sp_blocks":1,
"misc_tackles":0,
"misc_assists":0,
"misc_forced_fumbles":0,
"misc_fumble_recoveries":0,
"def_targets":3,
"def_comps":3,
"blitzes":5,
"hurries":0,
"knockdowns":1,
"missed_tackles":0,
"batted_passes":0,
"ast_sacks":0.0,
"def_yards_against":4,
"field_goal_blocks":0,
"punt_blocks":0,
"extra_point_blocks":1,
"def_touchdowns_against":0
}
},
"locale":"en",
"metadata":{
"league":"nfl",
"match":"sd:match:902a4753-72f9-4868-9d9b-193a5c41ea4d,sr:match:46791617",
"status":"closed",
"participant":"sd:player:c7929fb3-5437-42cc-a3c2-10b73ebb1fa0,sr:player:1695607",
"locale":"en",
"operation":"update",
"version":"v7"
}
}
'Reserve/Future' Player Status
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 04/19/2024 | Player Profile Team Profile Team Roster | Added FRES (Reserve/Future) as a valid player status. |
New Player Status
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 03/13/2024 | Player Profile Team Profile Team Roster | Added PRA_IR (Practice Squad Injured Reserve) as a valid player status. |
'Suspended' Game Status
| Release Date | Feeds Affected | Benefit |
| 07/28/2023 | Current 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 Date | Feeds Affected | Benefit |
| 07/28/2023 | Daily 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 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 Date | Feeds Affected | Benefit |
| 07/18/2023 | Current 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. |
New Drive Start/End Reasons
| Release Date | Feeds Affected | Update |
| 08/15/2022 | Game 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). |
New Position Added
| Release Date | Feeds Affected | Update |
| 08/15/2022 | Daily 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. |
Compensatory Draft Pick Support
| Release Date | Feeds Affected | Update |
| 04/13/2022 | Draft Summary Team Draft Summary Trades Push Draft Picks Push Draft Trades | Added support for compensatory draft picks to all relevant Draft feeds. |
New TD Stats
| Release Date | Feeds Affected | Update |
| 09/27/2021 | Game Statistics Player Profile Seasonal Statistics Push Statistics | Added the following data points: interception returns longest touchdown, kick returns longest touchdown, and punt returns longest touchdown. |
Removed Data Points
| Release Date | Feeds Affected | Update |
| 06/29/2021 | Game Boxscore Game Roster Game Statistics League Hierarchy Play-by-Play Player Profile Season Schedule Seasonal Statistics Team Profile Team Roster Weekly Depth Charts Weekly Injuries Weekly Schedule | Data points removed due to the data source changing: clock utc offset, reference ids, interception returns longest touchdown, kick returns longest touchdown, punt returns longest touchdown, event alternate description, last event alternate description, play alternate description, play clock, play scoring description, and rookie year. |
Removed Endpoints
| Release Date | Feeds Affected | Update |
| 04/20/2021 | Player Participation Standings Push Clock | Data points removed due to the removal of the endpoints. |
Removed Data
| Release Date | Feeds Affected | Update |
| 10/07/2020 | Game Boxscore Play-by-Play Push Events | Updated documentation to reflect data points that are no longer valid: `net_yards` (punts, kickoffs) and `fumble` (receiving, rush) |
Removed Endpoint
| Release Date | Feeds Affected | Update |
| 10/07/2020 | Weekly Rankings | Removed data points due to the end of support for the Weekly Rankings feed. |
Scoring Descriptions
| Release Date | Feeds Affected | Update |
| 10/14/2019 | Game Boxscore Play-by-Play Push Events | Added Scoring Description to play elements. |
Timeouts, Drive Data, and Play Types
| Release Date | Feeds Affected | Update |
| 07/25/2019 | Game Boxscore Play-by-Play Push Events | Added home/away remaining_timeouts and used_timeouts. Added drive data, period data, and points after. Added new data points for play_action and run_pass_option. |
Batted Passes & On Target Throws
| Release Date | Feeds Affected | Update |
| 07/25/2019 | Game Statistics Play-by-Play Season Statistics Push Events Push Statistics | Added data points for batted_passes (defense and passing) and on_target_throws. |
New Drive Data
| Release Date | Feeds Affected | Update |
| 07/25/2019 | Play-by-Play Push Events | Added drive data, period data, and points after play to the Push Events feeds. Added new data points for play_action and run_pass_option. |
Rankings Updates
| Release Date | Feeds Affected | Update |
| 07/25/2019 | Seasons Weekly Rankings | Added the following data points: end_date, start_date, status, and type – code. |
New Draft Endpoints
| Release Date | Feeds Affected | Update |
| 02/21/2019 | Draft Summary Prospects Team Draft Summary Top Prospects Trades Push Draft Picks Push Draft Trades | New feeds added to support draft information. |