NFL Next Generation Stats v1

Frequently Asked Questions
API API Version
NFL Next Generation Stats v1
Note: Authentication is required for all API calls.

Note: The NFL is not providing NGS tracking data for the Hall of Fame between Arizona and Dallas. NGS tracking data will be available for all other preseason games.
## Feed Availability
Note: To use NFL Next Generation Stats API you must also have access to the Official NFL API.
We package NGS data feeds into 3 distinct offerings. The content and timeliness of the data varies between packages. Below is a table that illustrates the packages and the feeds available in each. To see the timeliness of the data, see the details for each feed.
NGS
NGS Tracking
NGS Player Participation
Game Leaders
x
Game Play-By-Play
x
Game Play-By-Play+
x
Game Statistics
x
League Leaders
x
Play Statistics
x
Play Statistics+
x
Play Tracking Statistics
x
Player Participation
x
x
Player Seasonal Statistics
x
Team Leaders
x
Team Seasonal Statistics
x
Weekly League Leaders
x
## Game Leaders
Update Frequency: Real-time
Content Type: XML or JSON
Game Leaders Data Points: Leader Description
Leader Id
Player Id
Player Leader Rank
Player Leader Value
Players Type (Position)
Game Info Data Points: Id
Scheduled Date/Time
Type
Week
Year
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
Team Info Data Points: Alias
Id
Name Type
Play-by-Play Data Points: Play Clock
Play Description
Play Down
Play Id
Play Possessing Team
Play Quarter
Play Type
Yardline
Yardline Side
Yards to 1st Down
> To generate the Game Leaders replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/leaders.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/leaders.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/leaders.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Game Leaders feed by replacing the parameters in the following URL: https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/games/`{game_id}`/leaders.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `game_id` | ID of a given game. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Game Play-By-Play
Update Frequency: Real-time
Content Type: XML or JSON
Game Info Data Points: Away Team Alias
Away Team Id
Away Team Name
Away Team Personnel
Away Team Side
Away Team Type
Home Team Alias
Home Team Id
Home Team Name
Home Team Personnel
Home Team Side
Home Team Type
Id
Scheduled Date
Type
Week
Year
League Info Data Points: Season Season Type Week
Play-By-Play Data Points: Event Play Type
Event Sequence
Event Time
Play Clock
Play Deleted
Play Description
Play Down
Play Flags Penalty on Play
Play Flags Quarter Over
Play Flags Scoring Play
Play Flags Specials Team Play
Play Id
Play Possessing Team
Play Quarter
Play Type
Play Yardline
Play Yardline Side
Play Yards to 1st Down
Play Details Data Points: Distance Covered Jogging
Distance Covered Receiving
Distance Covered Running
Distance Covered Rushing
Distance Covered Special Teams
Distance Covered Sprinting
Distance Covered Total
Distance Covered Walking
Dist. Covered (Ball Carrier) - Receiving Plays
Dist. Covered (Ball Carrier) - Rushing Plays
Dist. Covered (Ball Carrier) - Special Teams Plays
Dist. Covered (Ball Carrier) - Total
Flags Defender in Box
Flags Is Ball Carrier
Flags Is Official
Flags Is On Route
Flags Is Receiver
Flags Nearest to QB at Throw
Flags Participation Official
Flags Pass Rusher
Flags Performance Official
Location Distance to QB at Throw
Location Lineup Left/Right of Center
Location Lineup Location Type
Passer Air Distance
Passer Dropback Distance
Passer Dropback Type
Passer Intended Air Distance
Passer Pass Location
Passer Time to Throw
Receiver Separation at Catch
Receiver Separation at Pass
Speed Average
Speed Maximum
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
> To generate the Game Play-By-Play for the Game ID below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/pbp.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/pbp.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/pbp.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the boxscore information for a specific game. https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/games/`{game_id}`/pbp.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `game_id` | ID of a given game. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Game Play-By-Play+ (plus)
Update Frequency: Real-time
Content Type: XML or JSON
Game Info Data Points: Away Team Alias
Away Team Id
Away Team Name
Away Team Personnel
Away Team Side
Away Team Type
Home Team Alias
Home Team Id
Home Team Name
Home Team Personnel
Home Team Side
Home Team Type
Id
Scheduled Date
Type
Week
Year
League Info Data Points: Season Season Type Week
Play-By-Play Data Points: Event Play Type
Event Sequence
Event Time
Play Clock
Play Deleted
Play Description
Play Down
Play Flags Penalty on Play
Play Flags Quarter Over
Play Flags Scoring Play
Play Flags Specials Team Play
Play Id
Play Possessing Team
Play Quarter
Play Type
Play Yardline
Play Yardline Side
Play Yards to 1st Down
Play Details Data Points: Distance Covered Jogging
Distance Covered Receiving Plays
Distance Covered Running
Distance Covered Rushing Plays
Distance Covered Special Teams Plays
Distance Covered Sprinting
Distance Covered Total
Distance Covered Walking
Dist. Covered (Ball Carrier) - Receiving Plays
Dist. Covered (Ball Carrier) - Rushing Plays
Dist. Covered (Ball Carrier) - Special Teams Plays
Dist. Covered (Ball Carrier) - Total
Flags Defender in Box
Flags Is Ball Carrier
Flags Is Official
Flags Is On Route
Flags Is Receiver
Flags Nearest to QB at Throw
Flags Participation Official
Flags Pass Rusher
Flags Performance Official
Location Distance to QB at Throw
Location Lineup Left/Right of Center
Location Lineup Location Type
Passer Air Distance
Passer Dropback Distance
Passer Dropback Type
Passer Intended Air Distance
Passer Pass Location
Passer Time to Throw
Receiver Separation at Catch
Receiver Separation at Pass
Speed Average
Speed Maximum
Tracking - Player Id
Tracking - Player First Name
Tracking - Player Last Name
Tracking - Player Position
Tracking - Player Position Group
Tracking - Location X Coordinate
Tracking - Location Y Coordinate
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
> To generate the Game Play-By-Play+ for the Game ID below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/tracked_pbp.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/tracked_pbp.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/tracked_pbp.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Play-by-Play+ information for a specific game. https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/games/`{game_id}`/tracked_pbp.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `game_id` | ID of a given game. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Game Statistics
Update Frequency: Real-time
Content Type: XML or JSON
Game Info Data Points: Away Team Alias
Away Team Id
Away Team Name
Away Team Type
Home Team Alias
Home Team Id
Home Team Name
Home Team Type
Id
Scheduled Date
Type
Week
Year
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
Player Game Statistics Data Points: Defense High Safety
Defense Time to Sack
Defense Defender in Box
Defense Pass Rusher
Defense Location Total
Defense Location Type
Distance Covered Jogging
Distance Covered Receiving Plays
Distance Covered Running
Distance Covered Rushing Plays
Distance Covered Special Teams Plays
Distance Covered Sprinting
Distance Covered Total
Distance Covered Walking
Distance Covered (Ball Carrier) Receiving Plays
Distance Covered (Ball Carrier) Rushing Plays
Distance Covered (Ball Carrier) Special Teams Plays
Distance Covered (Ball Carrier) Total
Offense Formation Total
Offense Formation Type
Offense Location Total
Offense Location Type
Offense Receiver
Offense Receiver on Route
Passing Air Distance
Passing Dropback Distance
Passing Intended Air Distance
Passing Time to Throw
Passing Dropback Total
Passing Dropback Type
Passing Location Total
Passing Location Type
Play Participation Defense
Play Participation Offense
Play Participation Receiving Plays
Play Participation Rushing Plays
Play Participation Special Teams Plays
Play Participation Total
Plays with Ball Receiving Plays
Plays with Ball Rushing Plays
Plays with Ball Special Teams Plays
Plays with Ball Total
Speed Average
Speed Maximum
Touches Receiving
Touches Rushing
Touches Special Teams
Team Game Statistics Data Points: Defense High Safety
Defense Time to Sack
Defense Defender in Box
Defense Pass Rusher
Defense Location Total
Defense Location Type
Defensive Plays Receiving
Defensive Plays Rushing
Defensive Plays Total
Dist. Covered by Position - Average
Dist. Covered by Position - Position Id
Dist. Covered by Position - Total
Distance Covered by Defense - Average
Distance Covered by Defense - Total
Distance Covered by Offense - Average
Distance Covered by Offense - Total
Offense Formation Total
Offense Formation Type
Offense Location Total
Offense Location Type
Offense Receiver
Offense Receiver on Route
Offensive Plays Receiving
Offensive Plays Rushing
Offensive Plays Total
Passing Air Distance
Passing Dropback Distance
Passing Intended Air Distance
Passing Time to Throw
Passing Dropback Total
Passing Dropback Type
Passing Location Total
Passing Location Type
Play Groups - Defense Distance Covered - Average
Play Groups - Defense Distance Covered - Total
Play Groups - Defense Play Types - Other
Play Groups - Defense Play Types - Receiving
Play Groups - Defense Play Types - Rushing
Play Groups - Defense Play Types - Total
Play Groups - Defense Yards Gained - Receiving
Play Groups - Defense Yards Gained - Rushing
Play Groups - Defense Yards Gained - Total
Play Groups - Name
Play Groups - Offense Distance Covered - Average
Play Groups - Offense Distance Covered - Total
Play Groups - Offense Play Types - Other
Play Groups - Offense Play Types - Receiving
Play Groups - Offense Play Types - Rushing
Play Groups - Offense Play Types - Total
Play Groups - Offense Yards Gained - Receiving
Play Groups - Offense Yards Gained - Rushing
Play Groups - Offense Yards Gained - Total
> To generate the Game Statistics for the Game ID below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/statistics.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/statistics.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/games/25fde8b4-6e4e-468c-ba0a-a511530a303c/statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the game statistics for a specific game. https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/games/`{game_id}`/statistics.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `game_id` | ID of a given game. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## League Leaders
Update Frequency: Post-game
Content Type: XML or JSON
League Info Data Points: Season Season Type Week
League Leaders Data Points: Leader Description
Leader Id
Player Id
Player Leader Rank
Player Leader Value
Players Type (Position)
Game Info Data Points: Id
Scheduled Date/Time
Type
Week
Year
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
Team Info Data Points: Alias
Id
Name Type
Play-by-Play Data Points: Play Clock
Play Description
Play Down
Play Id
Play Possessing Team
Play Quarter
Play Type
Yardline
Yardline Side
Yards to 1st Down
> To generate the League Leaders for the season below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/leaders.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/seasontd/2016/reg/leaders.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/leaders.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the league leaders for a specific season. https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/seasontd/`{year}`/`{nfl_season}`/leaders.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `year` | Year in 4 digit format (YYYY). | | `nfl_season` | Preseason (pre), Regular Season (reg), Postseason (pst). | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Play Statistics
Update Frequency: Real-time
Content Type: XML or JSON
Game Info Data Points: Away Team Alias
Away Team Id
Away Team Name
Away Team Personnel
Away Team Side
Away Team Type
Home Team Alias
Home Team Id
Home Team Name
Home Team Personnel
Home Team Side
Home Team Type
Id
Scheduled Date
Type
Week
Year
League Info Data Points: Season Season Type Week
Play-By-Play Info Data Points: Event Play Type
Event Sequence
Event Time
Play Clock
Play Deleted
Play Description
Play Down
Play Flags Penalty on Play
Play Flags Quarter Over
Play Flags Scoring Play
Play Flags Specials Team Play
Play Id
Play Possessing Team
Play Quarter
Play Type
Play Yardline
Play Yardline Side
Play Yards to 1st Down
Play Details Data Points: Distance Covered Jogging
Distance Covered Receiving
Distance Covered Running
Distance Covered Rushing
Distance Covered Special Teams
Distance Covered Sprinting
Distance Covered Total
Distance Covered Walking
Dist. Covered (Ball Carrier) - Receiving Plays
Dist. Covered (Ball Carrier) - Rushing Plays
Dist. Covered (Ball Carrier) - Special Teams Plays
Dist. Covered (Ball Carrier) - Total
Flags Defender in Box
Flags Is Ball Carrier
Flags Is Official
Flags Is On Route
Flags Is Receiver
Flags Nearest to QB at Throw
Flags Participation Official
Flags Pass Rusher
Flags Performance Official
Location Distance to QB at Throw
Location Lineup Left/Right of Center
Location Lineup Location Type
Passer Air Distance
Passer Dropback Distance
Passer Dropback Type
Passer Intended Air Distance
Passer Pass Location
Passer Time to Throw
Receiver Separation at Catch
Receiver Separation at Pass
Speed Average
Speed Maximum
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
> To generate Play Statistics replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/statistics.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/statistics.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves play statistics. https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/plays/`{play_id}`/statistics.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `play_id` | ID of a given play. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Play Statistics+ (plus)
Update Frequency: Real-time
Content Type: XML or JSON
Game Info Data Points: Away Team Alias
Away Team Defender in Box
Away Team Formation
Away Team High Safety
Away Team Id
Away Team Name
Away Team Pass Rusher
Away Team Personnel
Away Team Receiver
Away Team Receiver on Route
Away Team Side
Away Team Type
Home Team Alias
Home Team Defender in Box
Home Team Formation
Home Team High Safety
Home Team Id
Home Team Name
Home Team Pass Rusher
Home Team Personnel
Home Team Receiver
Home Team Receiver on Route
Home Team Side
Home Team Type
Id
Scheduled Date
Type
Week
Year
Play-By-Play Info Data Points: Event Play Type
Event Sequence
Event Time
Play Clock
Play Deleted
Play Description
Play Down
Play Flags Penalty on Play
Play Flags Quarter Over
Play Flags Scoring Play
Play Flags Specials Team Play
Play Id
Play Possessing Team
Play Quarter
Play Type
Play Yardline
Play Yardline Side
Play Yards to 1st Down
Play Details Data Points: Distance Covered Jogging
Distance Covered Receiving Plays
Distance Covered Running
Distance Covered Rushing Plays
Distance Covered Special Teams Plays
Distance Covered Sprinting
Distance Covered Total
Distance Covered Walking
Dist. Covered (Ball Carrier) - Receiving Plays
Dist. Covered (Ball Carrier) - Rushing Plays
Dist. Covered (Ball Carrier) - Special Teams Plays
Dist. Covered (Ball Carrier) - Total
Flags Defender in Box
Flags Is Ball Carrier
Flags Is Official
Flags Is On Route
Flags Is Receiver
Flags Nearest to QB at Throw
Flags Pass Rusher
Location Distance to QB at Throw
Location Lineup Left/Right of Center
Location Lineup Location Type
Passer Air Distance
Passer Dropback Distance
Passer Dropback Type
Passer Intended Air Distance
Passer Pass Location
Passer Time to Throw
Receiver Separation at Catch
Receiver Separation at Pass
Speed Average
Speed Maximum
Tracking - Player Id
Tracking - Player First Name
Tracking - Player Last Name
Tracking - Player Position
Tracking - Player Position Group
Tracking - Location X Coordinate
Tracking - Location Y Coordinate
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
> To generate Play Statistics+ replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/tracked_statistics.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/tracked_statistics.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/plays/83983e8b-bdd9-46bb-b150-7d0808b827aa/tracked_statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves play statistics+. https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/plays/`{play_id}`/tracked_statistics.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `play_id` | ID of a given play. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Play Tracking Statistics
Update Frequency: Real-time
Content Type: XML or JSON
Game Info Data Points: Away Team Alias
Away Team Defender in Box
Away Team Formation
Away Team High Safety
Away Team Id
Away Team Name
Away Team Pass Rusher
Away Team Personnel
Away Team Receiver
Away Team Receiver on Route
Away Team Side
Away Team Type
Home Team Alias
Home Team Defender in Box
Home Team Formation
Home Team High Safety
Home Team Id
Home Team Name
Home Team Pass Rusher
Home Team Personnel
Home Team Receiver
Home Team Receiver on Route
Home Team Side
Home Team Type
Id
Scheduled Date
Type
Week
Year
Play-By-Play Info Data Points: Play Clock
Play Deleted
Play Description
Play Down
Play Flags Penalty on Play
Play Flags Quarter Over
Play Flags Scoring Play
Play Flags Specials Team Play
Play Id
Play Possessing Team
Play Quarter
Play Type
Play Yardline
Play Yardline Side
Play Yards to 1st Down
Play Details Data Points: Location Direction
Location Distance
Location Speed
Location Time
Location Type
X Coordinate
Y Coordinate
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
> To generate the Play Tracking Statistics for the Play ID below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/tracking/7f844ff2-bf53-4dd9-b68f-3bff58226978/tracking.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/tracking/7f844ff2-bf53-4dd9-b68f-3bff58226978/tracking.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/tracking/7f844ff2-bf53-4dd9-b68f-3bff58226978/tracking.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Play Tracking Statistics for a specific play. https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/tracking/`{play_id}`/tracking.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `play_id` | ID of a given play. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Player Participation Participation Data is complementary data collected by the NFL that indicates all 22 players on the field for every play of every game.
Update Frequency: Real-time
Content Type: XML or JSON
Game Info Data Points: Away Team Alias
Away Team Id
Away Team Name
Home Team Alias
Home Team Id
Home Team Name
Id
Status
League Information Data Points: Season
Season Name
Season Type
Week
Week Sequence
Play-By-Play Data Points: Play Clock
Play Deleted
Play Description
Play Id
Play Type
Sequence
Player Information Data Points: Id
Name
Position
Position Group
Reference
Venue Data Points: Address
Capacity
City
Country
Id
Name
Roof Type
State
Surface
Zip
> To generate Participation Data replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/participation/b7aeb58f-7987-4202-bc41-3ad9a5b83fa4/participation.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/participation/b7aeb58f-7987-4202-bc41-3ad9a5b83fa4/participation.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/participation/b7aeb58f-7987-4202-bc41-3ad9a5b83fa4/participation.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Participation feed by replacing the parameters in the following URL: https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/participation/`{game_id}`/participation.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `game_id` | ID of a given game. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Player Seasonal Statistics
Update Frequency: Post-game
Content Type: XML or JSON
League Info Data Points: Season Season Type
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
Seasonal Player Statistics Data Points: Defense - High Safety
Defense - Time to Sack
Defense - Defender in Box
Defense - Pass Rusher
Defense - Location Total
Defense - Location Type
Distance Covered - Jogging
Distance Covered - Receiving Plays
Distance Covered - Running
Distance Covered - Rushing Plays
Distance Covered - ST Plays
Distance Covered - Sprinting
Distance Covered - Total
Distance Covered - Walking
Dist. Covered for Team - Jogging
Dist. Covered for Team - Receiving Plays
Dist. Covered for Team - Running
Dist. Covered for Team - Rushing Plays
Dist. Covered for Team - ST Plays
Dist. Covered for Team - Sprinting
Dist. Covered for Team - Total
Dist. Covered for Team - Walking
Dist. Covered (Ball Carrier) - Receiving Plays
Dist. Covered (Ball Carrier) - Rushing Plays
Dist. Covered (Ball Carrier) - ST Plays
Dist. Covered (Ball Carrier) - Total
Dist. Covered (Ball Carrier) for Team - Receiving Plays
Dist. Covered (Ball Carrier) for Team - Rushing Plays
Dist. Covered (Ball Carrier) for Team - ST Plays
Dist. Covered (Ball Carrier) for Team - Total
Offense - Formation Total
Offense - Formation Type
Offense - Location Total
Offense - Location Type
Offense - Receiver
Offense - Receiver on Route
Passing - Air Distance
Passing - Dropback Distance
Passing - Intended Air Distance
Passing - Time to Throw
Passing - Dropback Total
Passing - Dropback Type
Passing - Location Total
Passing - Location Type
Play Participation - Defense
Play Participation - Offense
Play Participation - Receiving Plays
Play Participation - Rushing Plays
Play Participation - ST Plays
Play Participation - Total Def/Off
Play Participation for Team - Defense
Play Participation for Team - Offense
Play Participation for Team - Receiving Plays
Play Participation for Team - Rushing Plays
Play Participation for Team - ST Plays
Play Participation for Team - Total Def/Off
Plays with Ball - Receiving Plays
Plays with Ball - Rushing Plays
Plays with Ball - Special Teams Plays
Plays with Ball - Total
Plays with Ball for Team - Receiving Plays
Plays with Ball for Team - Rushing Plays
Plays with Ball for Team - Special Teams Plays
Plays with Ball for Team - Total
Speed - Average
Speed - Maximum
Touches - Receiving Plays
Touches - Rushing Plays
Touches - Special Teams Plays
Seasonal Team Statistics Data Points: Defense - High Safety
Defense - Time to Sack
Defense - Defender in Box
Defense - Pass Rusher
Defense - Location Total
Defense - Location Type
Defensive Plays - Receiving Plays Against
Defensive Plays - Rushing Plays Against
Defensive Plays - Total Plays Against
Dist. Covered - Defense - Average Dist.
Dist. Covered - Defense - Total Dist.
Dist. Covered - Offense - Average Dist.
Dist. Covered - Offense - Total Dist.
Offense - Formation Total
Offense - Formation Type
Offense - Location Total
Offense - Location Type
Offense - Receiver
Offense - Receiver on Route
Offensive Plays - Receiving Plays
Offensive Plays - Rushing Plays
Offensive Plays - Total Plays
Passing - Air Distance
Passing - Dropback Distance
Passing - Intended Air Distance
Passing - Time to Throw
Passing - Dropback Total
Passing - Dropback Type
Passing - Location Total
Passing - Location Type
Speed - Average
Speed - Maximum
Touches - Receiving Plays
Touches - Rushing Plays
Touches - Special Teams Plays
Team Info Data Points: Alias
Id
Name Type
> To generate a Player Seasonal Statistics for the Player ID below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/players/2016/reg/91fc931a-acff-46d1-8233-182ce9635740/statistics.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/players/2016/reg/91fc931a-acff-46d1-8233-182ce9635740/statistics.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/players/2016/reg/91fc931a-acff-46d1-8233-182ce9635740/statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Player Seasonal Statistics for a specific player. https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/players/`{year}`/`{nfl_season}`/`{player_id}`/statistics.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `year` | Year in 4 digit format (YYYY). | | `nfl_season` | Preseason (pre), Regular Season (reg), Postseason (pst). | | `player_id` | ID for a given player. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Team Leaders
Update Frequency: Post-game
Content Type: XML or JSON
Game Info Data Points: Id
Scheduled Date/Time
Type
Week
Year
League Info Data Points: Season Season Type
Team Leaders Data Points: Leader Description
Leader Id
Player Id
Player Leader Rank
Player Leader Value
Players Type (Position)
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
Team Info Data Points: Alias
Id
Name Type
Play-by-Play Data Points: Play Clock
Play Description
Play Down
Play Id
Play Possessing Team
Play Quarter
Play Type
Yardline
Yardline Side
Yards to 1st Down
> To generate the Team Leaders for the Season and Year below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/33405046-04ee-4058-a950-d606f8c30852/leaders.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/seasontd/2016/reg/33405046-04ee-4058-a950-d606f8c30852/leaders.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/33405046-04ee-4058-a950-d606f8c30852/leaders.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Team Leaders for a team in a specific season. https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/seasontd/`{year}`/`{nfl_season}`/`{team_id}`/leaders.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `year` | Year in 4 digit format (YYYY). | | `nfl_season` | Preseason (pre), Regular Season (reg), Postseason (pst). | | `team_id` | ID for a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Team Seasonal Statistics
Update Frequency: Post-game
Content Type: XML or JSON
League Information Data Points: Season Season Type
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
Seasonal Player Statistics Data Points: Defense - High Safety
Defense - Time to Sack
Defense - Defender in Box
Defense - Pass Rusher
Defense - Location Total
Defense - Location Type
Dist. Covered - Jogging
Dist. Covered - Receiving Plays
Dist. Covered - Running
Dist. Covered - Rushing Plays
Dist. Covered - ST Plays
Dist. Covered - Sprinting
Dist. Covered - Total
Dist. Covered - Walking
Dist. Covered (Ball Carrier) - Receiving Plays
Dist. Covered (Ball Carrier) - Rushing Plays
Dist. Covered (Ball Carrier) - ST Plays
Dist. Covered (Ball Carrier) - Total
Offense - Formation Total
Offense - Formation Type
Offense - Location Total
Offense - Location Type
Offense - Receiver
Offense - Receiver on Route
Passing - Air Distance
Passing - Dropback Distance
Passing - Intended Air Distance
Passing - Time to Throw
Passing - Dropback Total
Passing - Dropback Type
Passing - Location Total
Passing - Location Type
Play Participation - Defense
Play Participation - Offense
Play Participation - Receiving Plays
Play Participation - Rushing Plays
Play Participation - ST Plays
Play Participation - Total Def/Off
Plays with Ball - Receiving Plays
Plays with Ball - Rushing Plays
Plays with Ball - ST Plays
Plays with Ball - Total
Speed - Average
Speed - Maximum
Touches - Receiving Plays
Touches - Rushing Plays
Touches - Special Teams Plays
Seasonal Team Statistics Data Points: Defense - High Safety
Defense - Time to Sack
Defense - Defender in Box
Defense - Pass Rusher
Defense - Location Total
Defense - Location Type
Defensive Plays - Receiving Plays Against
Defensive Plays - Rushing Plays Against
Defensive Plays - Total Plays Against
Dist. Covered By Position - Average
Dist. Covered By Position - Position Id
Dist. Covered By Position - Total
Dist. Covered - Defense - Average Dist.
Dist. Covered - Defense - Total Dist.
Dist. Covered - Offense - Average Dist.
Dist. Covered - Offense - Total Dist.
Offense - Formation Total
Offense - Formation Type
Offense - Location Total
Offense - Location Type
Offense - Receiver
Offense - Receiver on Route
Offensive Plays - Receiving Plays
Offensive Plays - Rushing Plays
Offensive Plays - Total Plays
Passing - Air Distance
Passing - Dropback Distance
Passing - Intended Air Distance
Passing - Time to Throw
Passing - Dropback Total
Passing - Dropback Type
Passing - Location Total
Passing - Location Type
Play Groups Defense - Dist. Covered - Average Dist. Allowed
Play Groups Defense - Dist. Covered - Total Dist. Allowed
Play Groups Defense - Play Types - Other
Play Groups Defense - Play Types - Receiving Plays
Play Groups Defense - Play Types - Rushing Plays
Play Groups Defense - Play Types - Total Plays
Play Groups Defense - Yrds Gained - Receiving Yards Allowed
Play Groups Defense - Yrds Gained - Rushing Yards Allowed
Play Groups Defense - Yrds Gained - Total Yards Allowed
Play Groups Name
Play Groups Offense - Dist. Covered - Average Dist.
Play Groups Offense - Dist. Covered - Total Dist.
Play Groups Offense - Play Types - Other
Play Groups Offense - Play Types - Receiving Plays
Play Groups Offense - Play Types - Rushing Plays
Play Groups Offense - Play Types - Total Plays
Play Groups Offense - Yrds Gained - Receiving Yards
Play Groups Offense - Yrds Gained - Rushing Yards
Play Groups Offense - Yrds Gained - Total Yards
Speed - Average
Speed - Maximum
Touches - Receiving Plays
Touches - Rushing Plays
Touches - Special Teams Plays
Team Info Data Points: Alias
Id
Name Type
> To generate the Team Seasonal Statistics for the Year and Season below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/teams/2016/reg/33405046-04ee-4058-a950-d606f8c30852/statistics.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/teams/2016/reg/33405046-04ee-4058-a950-d606f8c30852/statistics.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/teams/2016/reg/33405046-04ee-4058-a950-d606f8c30852/statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Team Seasonal Statistics for a season. https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/teams/`{year}`/`{nfl_season}`/`{team_id}`/statistics.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `year` | Year in 4 digit format (YYYY). | | `nfl_season` | Preseason (pre), Regular Season (reg), Postseason (pst). | | `team_id` | ID for a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Weekly League Leaders
Update Frequency: Post-game
Content Type: XML or JSON
Game Info Data Points: Id
Scheduled Date/Time
Type
Week
Year
League Info Data Points: Week Week Type Week Year
Weekly Leaders Data Points: Leader Description
Leader Id
Player Id
Player Leader Rank
Player Leader Value
Players Type (Position)
Player Info Data Points: First Name
Id
Last Name
Position
Position Group
Team Info Data Points: Alias
Id
Name Type
Play-by-Play Data Points: Play Clock
Play Description
Play Down
Play Id
Play Possessing Team
Play Quarter
Play Type
Yardline
Yardline Side
Yards to 1st Down
> To generate the Weekly Leaders for the week below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/02/leaders.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-ngs-t1/seasontd/2016/reg/02/leaders.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nfl-ngs-t1/seasontd/2016/reg/02/leaders.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Weekly Leaders. https://api.sportradar.us/nfl-ngs-`{access_level}{version}`/seasontd/`{year}`/`{nfl_season}`/`{week}`/leaders.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as trial (t), or production (p). | | `version` | Version number of the API you are accessing (current version: 1). | | `year` | Year in 4 digit format (YYYY). | | `nfl_season` | Preseason (pre), Regular Season (reg), Postseason (pst). | | `week` | Week in 2 digit format (WW). | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Frequently Asked Questions

Q: What format are date fields presented in?

A: When we present date only values we present these in the ISO 8601 standard format.
ex: 2013-04-03
We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601

Q: What format are the date/time fields presented in?

A: All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.
ex: 2013-04-03T18:15:00+00:00
For more information: https://en.wikipedia.org/wiki/ISO_8601

Q: What are the season types and their descriptions?

A: Here are the valid season types and their descriptions:

  • PRE – Pre-season
  • REG – Regular season
  • PST – Post-season

Q: What are the player positions I can expect to see?

A: Here are the valid player positions:

  • C
  • C/G
  • CB
  • CB/RS
  • CB/S
  • DB
  • DE
  • DE/LB
  • DL
  • DT
  • FB
  • FB/RB
  • FS
  • G
  • G/C
  • G/T
  • H/B
  • H/B/T
  • HB
  • ILB
  • K
  • KR
  • L
  • LB
  • LB/DE
  • LS
  • MLB
  • NT
  • OG
  • OL
  • OLB
  • OT
  • P
  • QB
  • RB
  • RB/ST
  • RB/WR
  • RS
  • S
  • SS
  • T
  • T/G
  • TE
  • TE/DT
  • TE/FB
  • TE/LS
  • TEW
  • WR
  • WR/CB
  • WR/KR
  • WR/PR
  • WR/RB
  • WR/RS

Q: How is the defensive alignment described in the feeds?

A: Using both “player - lineup_location_type” and “player - lineup_lr_of_center” values, you can get the location of where each defender lined up at the snap of the ball. Location types that end in zero (excluding zero itself) implies that the player is lined up in a linebacker position, off of the defensive line. Any number without a zero at the end, implies that the player lined up on the defensive line. Left and right of center values are from the perspective of the defense.

For easy reference, see the diagram below:

Q: What are the play types I can expect to see in the feeds?

A: Here are the valid play types:

  • extra_point
  • field_goal
  • kickoff
  • pass
  • punt
  • rush
  • sack
  • two_point_conversion
  • unknown

Q: What are the formations I can expect to see in the feeds?

A: Here are the valid formations:

  • ACE
  • EMPTY
  • I_FORM
  • JUMBO
  • PISTOL
  • SHOTGUN
  • WILDCAT

Q: What are the offensive lineup location types I can expect to see in the feeds?

A: Here are the valid offensive lineup location types:

  • BACKFIELD
  • LEFT_SLOT
  • LEFT_TIGHT
  • LEFT_WIDE
  • RIGHT_SLOT
  • RIGHT_TIGHT
  • RIGHT_WIDE

Q: What are the defensive lineup location types I can expect to see in the feeds?

A: Here are the valid defensive lineup location types:

  • FIVE
  • FIVE_ZERO
  • FOUR
  • FOUR_ZERO
  • LEFT_SLOT
  • LEFT_WIDE
  • NINE
  • NINE_ZERO
  • ONE
  • ONE_ZERO
  • RIGHT_SLOT
  • RIGHT_WIDE
  • SAFETY
  • SEVEN
  • SEVEN_ZERO
  • SIX
  • SIX_ZERO
  • THREE
  • THREE_ZERO
  • TWO
  • TWO_ZERO
  • ZERO
  • ZERO_ZERO

Q: What are the event types I can expect to see in the feeds?

A: Here are the valid event types:

  • AUDIT_TIME
  • BALL_SNAP
  • END_PATH
  • EXTRA_POINT
  • EXTRA_POINT_ATTEMPT
  • EXTRA_POINT_MISSED
  • EXTRA_POINT_BLOCKED
  • EXCLUDEDFROMPLAY
  • FAIR_CATCH
  • FIELD_GOAL
  • FIELD_GOAL_ATTEMPT
  • FIELD_GOAL_BLOCKED
  • FIELD_GOAL_MISSED
  • FIELD_GOAL_PLAY
  • FIRST_CONTACT
  • FREE_KICK
  • FREE_KICK_PLAY
  • FUMBLE
  • FUMBLE_OFFENSE_RECOVERED
  • FUMBLE_DEFENSE_RECOVERED
  • HANDOFF
  • HUDDLE_BREAK_OFFENSE
  • HUDDLE_START_OFFENSE
  • KICK_RECEIVED
  • KICKOFF
  • KICKOFF_LAND
  • KICKOFF_PLAY
  • KICK_RECOVERED
  • LINE_SET
  • MAN_IN_MOTION
  • ONSIDE_KICK
  • OUT_OF_BOUNDS
  • PASS_ARRIVED
  • PASS_FORWARD
  • PASS_LATERAL
  • PASS_OUTCOME_CAUGHT
  • PASS_OUTCOME_INCOMPLETE
  • PASS_OUTCOME_INTERCEPTION
  • PASS_OUTCOME_TOUCHDOWN
  • PASS_SHOVEL
  • PASS_TIPPED
  • PENALTY_ACCEPTED
  • PENALTY_DECLINED
  • PENALTY_FLAG
  • PLAY_MUFFED
  • PLAY_START
  • PLAY_SUBMIT
  • PLAY_STOPPED
  • PUNT
  • PUNT_BLOCKED
  • PUNT_DOWNED
  • PUNT_LAND
  • PUNT_PLAY
  • PUNT_RECEIVED
  • QB_KNEEL
  • QB_SACK
  • QB_STRIP_SACK
  • RUN
  • SAFETY
  • SHIFT
  • SNAP_DIRECT
  • SYSTEM_NOTE
  • TACKLE
  • TIMEOUT
  • TIMEOUT_AWAY
  • TIMEOUT_BOOTH_REVIEW
  • TIMEOUT_HALFTIME
  • TIMEOUT_HOME
  • TIMEOUT_INJURY
  • TIMEOUT_QUARTER
  • TIMEOUT_TV
  • TOUCHBACK
  • TOUCHDOWN
  • TWO_MINUTE_WARNING
  • TWO_POINT_CONVERSION
  • TWO_POINT_PLAY
  • XP_PLAY

Q: What are the pass locations I can expect to see in the feeds?

A: Here are the valid pass locations:

  • INSIDE BOX
  • OUTSIDE LEFT
  • OUTSIDE RIGHT
  • UNKNOWN

Q: What are the dropback types I can expect to see in the feeds?

A: Here are the valid dropback types:

  • ROLLOUT
  • SCRAMBLE
  • TRADITIONAL
  • UNKNOWN
Return to top