Classic NFL v1

Frequently Asked Questions
API API Version Data Entry Workflow
Classic NFL v1 Workflow
Note: Authentication is required for all API calls.
## Classic NFL API Map To best utilize the Classic NFL API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need. >

Examples:

>To find the team rosters for a given game: >
  1. Call the season or weekly schedule and find the Team Ids for the given game
  2. Call the Game Roster using the Team Ids
>The rosters for the game are displayed. >
    >To find the starting situation of a given play: >
    1. Call the season or weekly schedule and find the Team Ids for the given game
    2. Call the Play-By-Play using the Team Ids
    3. Locate the Play Id for the play you want
    4. Call the Play Summary and find the starting situation data point
    >The starting situation of the play is displayed. Primary feeds only require dates or human-readable parameters, while other feeds require identifiers (IDs) to identify the game, team, or play that the feed will discribe. The primary feeds provide IDs for games and teams, while games provide IDS for plays. ## Extended Boxscore Top-level team scores by quarter along with team leaders in passing, rushing, and receiving.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Boxscore Data Points: Away Team Challenges Remaining
    Away Team Points for Quarter
    Away Team Timeouts Remaining
    Away Team Total Points
    Clock
    Home Team Challenges Remaining
    Home Team Points for Quarter
    Home Team Timeouts Remaining
    Home Team Total Points
    Last Event Clock
    Last Event Description
    Last Event Sequence
    Last Event Type
    Last Event Updated
    Quarter
    Possession Down
    Possession Team
    Possession Time
    Possession Side
    Possession Yard Line
    Possession Yards For Down
    Scoring Away Team Points
    Scoring Clock
    Scoring Drive Quarter
    Scoring Drive Sequence
    Scoring Drive Starting Game Clock
    Scoring Drive Team Id
    Scoring Home Team Points
    Scoring Play Description
    Scoring Play Id
    Scoring Play Type
    Scoring Points
    Scoring Quarter
    Scoring Team Id
    Game Info Data Points: Away Team Id
    Away Team Market
    Away Team Name
    Completion Date/Time
    Home Team Id
    Home Team Market
    Home Team Name
    Id
    Scheduled Start Date/Time
    Status
    Player Game Statistics Data Points: Passing 10+ Yards
    Passing 20+ Yards
    Passing 30+ Yards
    Passing 40+ Yards
    Passing 50+ Yards
    Passing Attempts
    Passing Average Yards
    Passing Average Yards per Completion
    Passing Completion Percentage
    Passing Completions
    Passing First Downs
    Passing Interception Percentage
    Passing Interceptions
    Passing Ints Returned for Touchdown
    Passing Longest
    Passing Rating
    Passing Red Zone Attempts
    Passing Sack Yards
    Passing Sacks
    Passing Safeties
    Passing Touchdowns
    Passing Touchdowns Percentage
    Passing Yards
    Receiving 10+ Yards
    Receiving 20+ Yards
    Receiving 30+ Yards
    Receiving 40+ Yards
    Receiving 50+ Yards
    Receiving Average Yards
    Receiving First Downs
    Receiving Fumbles
    Receiving Longest
    Receiving Receptions
    Receiving Red Zone Targets
    Receiving Targets
    Receiving Touchdowns
    Receiving Yards
    Receiving Yards After Catch
    Rushing 10+ Yards
    Rushing 20+ Yards
    Rushing 30+ Yards
    Rushing 40+ Yards
    Rushing 50+ Yards
    Rushing Attempts
    Rushing Average Yards
    Rushing First Down Percentage
    Rushing First Downs
    Rushing Fumbles
    Rushing Longest
    Rushing Red Zone Attempts
    Rushing Safeties
    Rushing Touchdowns
    Rushing Yards
    > To generate the Extended Boxscore replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/min/ten/extended-boxscore.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-t1/2016/reg/1/min/ten/extended-boxscore.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-t1/2016/reg/1/min/ten/extended-boxscore.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Extended Boxscore feed by replacing the parameters in the following URL: https://api.sportradar.us/nfl-`{access_level}{version}`/`{year}`/`{nfl_season}`/`{week}`/`{away_team}`/`{home_team}`/extended-boxscore.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `away_team` | Abbreviated team name. | | `home_team` | Abbreviated team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Extended Boxscore, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/extended-boxscore-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Game Boxscore This feed displays game scoring information for each team, including play information for all scoring drives.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Boxscore Data Points: Away Team Challenges Remaining
    Away Team Points for Quarter
    Away Team Timeouts Remaining
    Away Team Total Points
    Clock
    Home Team Challenges Remaining
    Home Team Points for Quarter
    Home Team Timeouts Remaining
    Home Team Total Points
    Quarter
    Quarter Number
    Scoring Away Team Points
    Scoring Clock
    Scoring Drive Quarter
    Scoring Drive Sequence
    Scoring Drive Starting Game Clock
    Scoring Drive Team Id
    Scoring Home Team Points
    Scoring Play Description
    Scoring Play Id
    Scoring Play Type
    Scoring Points
    Scoring Quarter
    Scoring Team Id
    Game Info Data Points: Away Team Id
    Away Team Market
    Away Team Name
    Completion Date/Time
    Home Team Id
    Home Team Market
    Home Team Name
    Id
    Scheduled Start Date/Time
    Status
    > To generate the Game Boxscore for the Game below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/min/ten/boxscore.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-t1/2016/reg/1/min/ten/boxscore.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-t1/2016/reg/1/min/ten/boxscore.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-`{access_level}{version}`/`{year}`/`{nfl_season}`/`{week}`/`{away_team}`/`{home_team}`/boxscore.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `away_team` | Abbreviated team name. | | `home_team` | Abbreviated team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Game Boxscore, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/boxscore-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Game Depth Chart Team depth chart rankings for every position in the game.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Depth Chart Data Points: Depth Chart Position Position Description Position Name
    Game Info Data Points: Away Team Id
    Home Team Id
    Id
    Scheduled Start Date/Time
    Status
    Player Info Data Points: Full Name
    Id
    Jersey Number
    Position
    Status
    Team Info Data Points: Id Market Name
    > To generate the Game Depth Chart for the Game below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/min/ten/depthchart.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-t1/2016/reg/1/min/ten/depthchart.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-t1/2016/reg/1/min/ten/depthchart.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the depth chart information for a specific game. https://api.sportradar.us/nfl-`{access_level}{version}`/`{year}`/`{nfl_season}`/`{week}`/`{away_team}`/`{home_team}`/depthchart.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `away_team` | Abbreviated team name. | | `home_team` | Abbreviated team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Game Boxscore, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/depth_chart-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Game Roster Player information for each match-up, including height/weight, jersey number, position, and injury status.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Info Data Points: Away Team Id
    Home Team Id
    Id
    Scheduled Start Date/Time
    Status
    Injuries Data Points: Description
    Game Status
    Id
    Practice Status
    Start Date
    Player Info Data Points: Abbreviated Name
    Birth Date
    College
    First Name
    Full Name
    Height
    Id
    Jersey Number
    Last Name
    Played
    Position
    Salary
    Started
    Status
    Weight
    Team Info Data Points: Coach Abbreviated Name
    Coach First Name
    Coach Full Name
    Coach Id
    Coach Last Name
    Coach Position
    Coach Salary
    Coach Status
    Id
    Market
    Name
    > To generate the Game Roster for the game below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/min/ten/roster.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-t1/2016/reg/1/min/ten/roster.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-t1/2016/reg/1/min/ten/roster.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the game roster for a specific game. https://api.sportradar.us/nfl-`{access_level}{version}`/`{year}`/`{nfl_season}`/`{week}`/`{away_team}`/`{home_team}`/roster.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `away_team` | Abbreviated team name. | | `home_team` | Abbreviated team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Game Roster, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/roster-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Game Statistics Detailed game stats at the player and team level, including offense, defense, and special teams breakouts.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Boxscore Data Points: Away Team Challenges Remaining
    Away Team Timeouts Remaining
    Away Team Total Points
    Home Team Challenges Remaining
    Home Team Timeouts Remaining
    Home Team Total Points
    Game Info Data Points: Away Team Id
    Home Team Id
    Id
    Scheduled Start Date/Time
    Status
    Player Game Statistics Data Points: Blocked Field Goal Return 10+ Yards
    Blocked Field Goal Return 20+ Yards
    Blocked Field Goal Return 30+ Yards
    Blocked Field Goal Return 40+ Yards
    Blocked Field Goal Return 50+ Yards
    Blocked Field Goal Return Average Yards
    Blocked Field Goal Return Fair Catches
    Blocked Field Goal Return Longest
    Blocked Field Goal Return Returns
    Blocked Field Goal Return Touchdowns
    Blocked Field Goal Return Yards
    Conversions Extra Points Attempts
    Conversions Extra Points Blocked
    Conversions Extra Points Made
    Conversions Extra Points Percentage
    Defense 1pt Safeties
    Defense Assisted Tackles
    Defense Blocks
    Defense Combined Tackles
    Defense Conversions Attempts
    Defense Conversions Failed
    Defense Conversions Made
    Defense Fumbles Forced
    Defense Fumbles Recoveries
    Defense Fumbles Touchdowns
    Defense Interceptions
    Defense Interceptions Longest
    Defense Interceptions Touchdowns
    Defense Interceptions Yards
    Defense Miscellaneous Assisted Tackles
    Defense Miscellaneous Combined Tackles
    Defense Miscellaneous Forced Fumbles
    Defense Miscellaneous Fumble Recoveries
    Defense Miscellaneous Tackles
    Defense Passes Defended
    Defense QB Hits
    Defense Sack Yards
    Defense Sacks
    Defense Safeties
    Defense Special Teams Assisted Tackles
    Defense Special Teams Combined Tackles
    Defense Special Teams Forced Fumbles
    Defense Special Teams Fumble Recoveries
    Defense Special Teams Tackles
    Defense Tackles
    Defense Tackles for Loss
    Field Goals Attempts
    Field Goals Attempts 1-19 Yards
    Field Goals Attempts 20-29 Yards
    Field Goals Attempts 30-39 Yards
    Field Goals Attempts 40-49 Yards
    Field Goals Attempts 50+ Yards
    Field Goals Blocked
    Field Goals Longest
    Field Goals Made
    Field Goals Made 1-19 Yards
    Field Goals Made 20-29 Yards
    Field Goals Made 30-39 Yards
    Field Goals Made 40-49 Yards
    Field Goals Made 50+ Yards
    Field Goals Percentage
    First Downs Passing
    First Downs Penalty
    First Downs Rushing
    First Downs Total
    Fumbles Force Fumbles
    Fumbles Fumbles
    Fumbles Lost Fumbles
    Fumbles Opponent Recovery
    Fumbles Opponent Recovery Touchdowns
    Fumbles Opponent Recovery Yards
    Fumbles Out of Bounds
    Fumbles Own Recovery
    Fumbles Own Recovery Touchdowns
    Fumbles Own Recovery Yards
    Kick Returns 10+ Yards
    Kick Returns 20+ Yards
    Kick Returns 30+ Yards
    Kick Returns 40+ Yards
    Kick Returns 50+ Yards
    Kick Returns Average Yards
    Kick Returns Fair Catches
    Kick Returns Longest
    Kick Returns Returns
    Kick Returns Touchdowns
    Kick Returns Yards
    Kickoffs Average Kick
    Kickoffs Average Return
    Kickoffs End Zone
    Kickoffs Insdie 20 Percentage
    Kickoffs Inside 20
    Kickoffs Kickoffs
    Kickoffs Longest
    Kickoffs Net Average
    Kickoffs Net Yards
    Kickoffs Return Yards
    Kickoffs Returns
    Kickoffs Touchback Percentage
    Kickoffs Touchbacks
    Kickoffs Yards
    Passing 10+ Yards
    Passing 20+ Yards
    Passing 30+ Yards
    Passing 40+ Yards
    Passing 50+ Yards
    Passing Attempts
    Passing Average Yards
    Passing Average Yards per Completion
    Passing Completion Percentage
    Passing Completions
    Passing First Downs
    Passing Interception Percentage
    Passing Interceptions
    Passing Ints Returned for Touchdown
    Passing Longest
    Passing Rating
    Passing Red Zone Attempts
    Passing Sack Yards
    Passing Sacks
    Passing Safeties
    Passing Touchdowns
    Passing Touchdowns Percentage
    Passing Yards
    Penalties Penalties
    Penalties Penalty First Downs
    Penalties Penalty Yards
    Punt Returns 10+ Yards
    Punt Returns 20+ Yards
    Punt Returns 30+ Yards
    Punt Returns 40+ Yards
    Punt Returns 50+ Yards
    Punt Returns Average Yards
    Punt Returns Fair Catches
    Punt Returns Longest
    Punt Returns Returns
    Punt Returns Touchdowns
    Punt Returns Yards
    Punts Attempts
    Punts Average Net Yards
    Punts Average Return
    Punts Average Yards
    Punts Blocked
    Punts Inside 20
    Punts Inside 20 Percentage
    Punts Longest
    Punts Net Yards
    Punts Return Yards
    Punts Returns
    Punts Safeties
    Punts Touchback Percentage
    Punts Touchbacks
    Punts Yards
    Receiving 10+ Yards
    Receiving 20+ Yards
    Receiving 30+ Yards
    Receiving 40+ Yards
    Receiving 50+ Yards
    Receiving Average Yards
    Receiving First Downs
    Receiving Fumbles
    Receiving Longest
    Receiving Receptions
    Receiving Red Zone Targets
    Receiving Targets
    Receiving Touchdowns
    Receiving Yards
    Receiving Yards After Catch
    Rushing 10+ Yards
    Rushing 20+ Yards
    Rushing 30+ Yards
    Rushing 40+ Yards
    Rushing 50+ Yards
    Rushing Attempts
    Rushing Average Yards
    Rushing First Down Percentage
    Rushing First Downs
    Rushing Fumbles
    Rushing Longest
    Rushing Red Zone Attempts
    Rushing Safeties
    Rushing Touchdowns
    Rushing Yards
    Touchdowns Field Goal Return
    Touchdowns Fumble Return
    Touchdowns Interception Return
    Touchdowns Kick Return
    Touchdowns Other
    Touchdowns Passing
    Touchdowns Punt Return
    Touchdowns Rushing
    Two Point Conversion Attempted
    Two Point Conversion Passing
    Two Point Conversion Receving
    Two Point Conversion Rushing
    Team Game Statistics Data Points: Blocked Field Goal Return 10+ Yards
    Blocked Field Goal Return 20+ Yards
    Blocked Field Goal Return 30+ Yards
    Blocked Field Goal Return 40+ Yards
    Blocked Field Goal Return 50+ Yards
    Blocked Field Goal Return Average Yards
    Blocked Field Goal Return Fair Catches
    Blocked Field Goal Return Longest
    Blocked Field Goal Return Returns
    Blocked Field Goal Return Touchdowns
    Blocked Field Goal Return Yards
    Conversions Extra Points Attempts
    Conversions Extra Points Blocked
    Conversions Extra Points Made
    Conversions Extra Points Percentage
    Defense 1pt Safeties
    Defense Assisted Tackles
    Defense Blocks
    Defense Combined Tackles
    Defense Conversions Attempts
    Defense Conversions Failed
    Defense Conversions Made
    Defense Fumbles Forced
    Defense Fumbles Recoveries
    Defense Fumbles Touchdowns
    Defense Interceptions
    Defense Interceptions Longest
    Defense Interceptions Touchdowns
    Defense Interceptions Yards
    Defense Miscellaneous Assisted Tackles
    Defense Miscellaneous Combined Tackles
    Defense Miscellaneous Forced Fumbles
    Defense Miscellaneous Fumble Recoveries
    Defense Miscellaneous Tackles
    Defense Passes Defended
    Defense QB Hits
    Defense Sack Yards
    Defense Sacks
    Defense Safeties
    Defense Special Teams Assisted Tackles
    Defense Special Teams Combined Tackles
    Defense Special Teams Forced Fumbles
    Defense Special Teams Fumble Recoveries
    Defense Special Teams Tackles
    Defense Tackles
    Defense Tackles for Loss
    Efficiency 3rd Down Attempts
    Efficiency 3rd Down Conversions
    Efficiency 3rd Down Conversions via Pass
    Efficiency 3rd Down Conversions via Penalty
    Efficiency 3rd Down Conversions via Rush
    Efficiency 3rd Down Percentage
    Efficiency 4th Down Attempts
    Efficiency 4th Down Conversions
    Efficiency 4th Down Conversions via Pass
    Efficiency 4th Down Conversions via Penalty
    Efficiency 4th Down Conversions via Rush
    Efficiency 4th Down Percentage
    Efficiency Goal to Go Attempts
    Efficiency Goal to Go Conversions
    Efficiency Goal to Go Percentage
    Efficiency Red Zone Attempts
    Efficiency Red Zone Conversions
    Efficiency Red Zone Percentage
    Field Goals Attempts
    Field Goals Attempts 1-19 Yards
    Field Goals Attempts 20-29 Yards
    Field Goals Attempts 30-39 Yards
    Field Goals Attempts 40-49 Yards
    Field Goals Attempts 50+ Yards
    Field Goals Longest
    Field Goals Made
    Field Goals Made 1-19 Yards
    Field Goals Made 20-29 Yards
    Field Goals Made 30-39 Yards
    Field Goals Made 40-49 Yards
    Field Goals Made 50+ Yards
    Field Goals Percentage
    First Downs Passing
    First Downs Penalty
    First Downs Rushing
    First Downs Total
    Fumbles Force Fumbles
    Fumbles Fumbles
    Fumbles Lost Fumbles
    Fumbles Opponent Recovery
    Fumbles Opponent Recovery Touchdowns
    Fumbles Opponent Recovery Yards
    Fumbles Out of Bounds
    Fumbles Own Recovery
    Fumbles Own Recovery Touchdowns
    Fumbles Own Recovery Yards
    Kick Returns 10+ Yards
    Kick Returns 20+ Yards
    Kick Returns 30+ Yards
    Kick Returns 40+ Yards
    Kick Returns 50+ Yards
    Kick Returns Average Yards
    Kick Returns Fair Catches
    Kick Returns Longest
    Kick Returns Returns
    Kick Returns Touchdowns
    Kick Returns Yards
    Kickoffs Average Kick
    Kickoffs Average Return
    Kickoffs End Zone
    Kickoffs Inside 20
    Kickoffs Inside 20 Percentage
    Kickoffs Kickoffs
    Kickoffs Longest
    Kickoffs Net Average
    Kickoffs Net Yards
    Kickoffs Return Yards
    Kickoffs Returns
    Kickoffs Touchback Percentage
    Kickoffs Touchbacks
    Kickoffs Yards
    Passing 10+ Yards
    Passing 20+ Yards
    Passing 30+ Yards
    Passing 40+ Yards
    Passing 50+ Yards
    Passing Attempts
    Passing Average Yards
    Passing Average Yards per Completion
    Passing Completion Percentage
    Passing Completions
    Passing First Downs
    Passing Interception Percentage
    Passing Interceptions
    Passing Ints Returned for Touchdown
    Passing Longest
    Passing Rating
    Passing Red Zone Attempts
    Passing Sack Yards
    Passing Sacks
    Passing Safeties
    Passing Touchdowns
    Passing Touchdowns Percentage
    Passing Yards
    Penalties Penalties
    Penalties Penalty First Downs
    Penalties Penalty Yards
    Punt Returns 10+ Yards
    Punt Returns 20+ Yards
    Punt Returns 30+ Yards
    Punt Returns 40+ Yards
    Punt Returns 50+ Yards
    Punt Returns Average Yards
    Punt Returns Fair Catches
    Punt Returns Longest
    Punt Returns Returns
    Punt Returns Touchdowns
    Punt Returns Yards
    Punts Attempts
    Punts Average Net Yards
    Punts Average Return
    Punts Average Yards
    Punts Blocked
    Punts Inside 20
    Punts Inside 20 Percentage
    Punts Longest
    Punts Net Yards
    Punts Return Yards
    Punts Returns
    Punts Safeties
    Punts Touchback Percentage
    Punts Touchbacks
    Punts Yards
    Receiving 10+ Yards
    Receiving 20+ Yards
    Receiving 30+ Yards
    Receiving 40+ Yards
    Receiving 50+ Yards
    Receiving Average Yards
    Receiving First Downs
    Receiving Fumbles
    Receiving Longest
    Receiving Receptions
    Receiving Red Zone Targets
    Receiving Targets
    Receiving Touchdowns
    Receiving Yards
    Receiving Yards After Catch
    Rushing 10+ Yards
    Rushing 20+ Yards
    Rushing 30+ Yards
    Rushing 40+ Yards
    Rushing 50+ Yards
    Rushing Attempts
    Rushing Average Yards
    Rushing First Down Percentage
    Rushing First Downs
    Rushing Fumbles
    Rushing Longest
    Rushing Red Zone Attempts
    Rushing Safeties
    Rushing Touchdowns
    Rushing Yards
    Touchdowns Field Goal Return
    Touchdowns Fumble Return
    Touchdowns Interception Return
    Touchdowns Kick Return
    Touchdowns Other
    Touchdowns Pass
    Touchdowns Punt Return
    Touchdowns Rush
    Two Point Conversions Attempted
    Two Point Conversions Failed
    Two Point Conversions Passing
    Two Point Conversions Receiving
    Two Point Conversions Rushing
    Player Info Data Points: Full Name
    Id
    Jersey Number Position
    Team Info Data Points: Id Market Name
    > To generate the Game Statistics replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/min/ten/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-t1/2016/reg/1/min/ten/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-t1/2016/reg/1/min/ten/statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Game Statistics. https://api.sportradar.us/nfl-`{access_level}{version}`/`{year}`/`{nfl_season}`/`{week}`/`{away_team}`/`{home_team}`/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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `away_team` | Abbreviated team name. | | `home_team` | Abbreviated team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Game Statistics, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/statistics-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Game Summary Team comparisons for all major stat categories within a game, as well as deeper insights such as third/fourth down and red zone efficiency.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Info Data Points: Away Team Id
    Home Team Id
    Id
    Scheduled Start Date/Time
    Status
    Team Summary Game Statistics Data Points: 3rd Down Efficiency Attempts
    3rd Down Efficiency Converted
    3rd Down Efficiency Percentage
    3rd Down Efficiency Via Pass
    3rd Down Efficiency Via Penalty
    3rd Down Efficiency Via Rush
    4th Down Efficiency Attempts
    4th Down Efficiency Converted
    4th Down Efficiency Percentage
    4th Down Efficiency Via Pass
    4th Down Efficiency Via Penalty
    4th Down Efficiency Via Rush
    Extra Points 2 Pt Conversion Attempts
    Extra Points 2 Pt Conversion Made
    Extra Points Attempts
    Extra Points Kicking Attempts
    Extra Points Kicking Blocked
    Extra Points Kicking Made
    Extra Points Made
    Field Goals Attempts
    Field Goals Blocked
    Field Goals Made
    Final Score
    First Downs Total
    First Downs Via Pass
    First Downs Via Penalty
    First Downs Via Rush
    Fumbles Lost
    Fumbles Total
    Goal Efficiency Attempts
    Goal Efficiency Percentage
    Goal Efficiency Touchdowns
    Kickoffs End Zone
    Kickoffs Total
    Kickoffs Touchbacks
    Passing Attempts
    Passing Average
    Passing Completions
    Passing Gross Yards
    Passing Interceptions
    Passing Net Yards
    Passing Sack Yards
    Passing Sacks
    Penalties Total
    Penalties Yards
    Punts Average
    Punts Blocked
    Punts Net Average
    Punts Total
    Red Zone Efficiency Attempts
    Red Zone Efficiency Percentage
    Red Zone Efficiency Touchdowns
    Returns Int Return Yards
    Returns Int Returns
    Returns Kick Return Yards
    Returns Kick Returns
    Returns Punt Return Yards
    Returns Punt Returns
    Returns Total Yardage
    Rushing Average
    Rushing Plays
    Rushing Yards
    Safeties
    Time of Possession
    Total Yards Average
    Total Yards Plays
    Total Yards Yards
    Touchdowns Field Goal Return
    Touchdowns Fumble Return
    Touchdowns Interception
    Touchdowns Kickoff Return
    Touchdowns Passing
    Touchdowns Punt Return
    Touchdowns Rushing
    Touchdowns Total
    Turnovers
    Data Points: Id Market Name
    > To generate the Game Summary for the game below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/min/ten/summary.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-t1/2016/reg/1/min/ten/summary.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-t1/2016/reg/1/min/ten/summary.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Game Summary information for a specific game. https://api.sportradar.us/nfl-`{access_level}{version}`/`{year}`/`{nfl_season}`/`{week}`/`{away_team}`/`{home_team}`/summary.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `away_team` | Abbreviated team name. | | `home_team` | Abbreviated team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Game Summary, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/summary-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Injuries Detailed information on injuries, including the injury type, and the player's game and practice status.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Info Data Points: Away Team Id
    Home Team Id
    Id
    Scheduled Start Date/Time
    Status
    Injuries Data Points: Description
    Game Status
    Id
    Practice Status
    Start Date
    Player Info Data Points: Full Name
    Id
    Jersey Number
    Position
    Status
    Team Info Data Points: Id Market Name
    > To generate the Injuries for the game below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/min/ten/injuries.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-t1/2016/reg/1/min/ten/injuries.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-t1/2016/reg/1/min/ten/injuries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Injuries for a specific game. https://api.sportradar.us/nfl-`{access_level}{version}`/`{year}`/`{nfl_season}`/`{week}`/`{away_team}`/`{home_team}`/injuries.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `away_team` | Abbreviated team name. | | `home_team` | Abbreviated team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Injuries, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/roster-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Play-By-Play Detailed, real-time information on every team possession and game event.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Boxscore Data Points: Away Team Challenges Remaining
    Away Team Timeouts Remaining
    Away Team Total Points
    Home Team Challenges Remaining
    Home Team Timeouts Remaining
    Home Team Total Points
    Quarter
    Game Info Data Points: Away Team Id
    Completion Date/Time
    Home Team Id
    Id
    Scheduled Start Date/Time
    Status
    Play-By-Play Data Points: Drive Clock
    Drive Id
    Drive Team
    Event Clock
    Event Outcome
    Event Sequence
    Event Summary
    Event Type
    Event Updated
    Event Winner
    Game Quarter
    Play Clock
    Play Direction
    Play Down
    Play Formation
    Play Id
    Play Sequence
    Play Side
    Play Summary
    Play Type
    Play Yard Line
    Play Yards To First Down
    Play Defensive Action
    Play Defensive Formation
    Play Distance
    Play Official
    Play Overturned
    Play Score Points
    Play Score Type
    Play Scoring Team
    Play Updated Date/Time
    Play Participant Jersey Number
    Play Participant Player Id
    Play Participant Player Name
    Play Participant Position
    Play Participant Team
    Player Info Data Points: Full Name
    Id
    Jersey Number Position
    > To generate the Play-By-Play for the game below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/min/ten/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-t1/2016/reg/1/min/ten/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-t1/2016/reg/1/min/ten/pbp.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Play-By-Play for a specific game. https://api.sportradar.us/nfl-`{access_level}{version}`/`{year}`/`{nfl_season}`/`{week}`/`{away_team}`/`{home_team}`/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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `away_team` | Abbreviated team name. | | `home_team` | Abbreviated team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Play-By-Play, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/pbp-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Play Summary Real-time play detail for every game play.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Play Info Data Points: Ending Situation Down
    Ending Situation Side
    Ending Situation Team
    Ending Situation Yard Line
    Ending Situation Yards To First Down
    Play Clock
    Play Direction
    Play Formation
    Play Game Id
    Play Id
    Play Summary
    Play Type
    Play Controller
    Play Defensive Action
    Play Defensive Formation
    Play Distance
    Play Official
    Play Progression From Side
    Play Progression From Yard Line
    Play Progression Sequence
    Play Progression Team Id
    Play Progression To Side
    Play Progression To Yard Line
    Play Quarter
    Play Score Points
    Play Score Type
    Play Scoring Team
    Play Updated Date/Time
    Play Participant Jersey Number
    Play Participant Player Id
    Play Participant Player Name
    Play Participant Position
    Play Participant Team
    Starting Situation Down
    Starting Situation Side
    Starting Situation Team
    Starting Situation Yard Line
    Starting Situation Yards To First Down
    Play Statistics Data Points: Blocked Field Goal Returns Fair Catches
    Blocked Field Goal Returns
    Blocked Field Goal Returns Total Yards
    Blocked Field Goal Returns Touchdowns
    Blocked Punt Returns Fair Catches
    Blocked Punt Returns Returns
    Blocked Punt Returns Total Yards
    Blocked Punt Returns Touchdowns
    Conversions 2pt Attempted
    Conversions 2pt Category
    Conversions 2pt Made
    Conversions Defensive Attempts
    Conversions Defensive Category
    Conversions Defensive Made
    Conversions Extra Points Attempts
    Conversions Extra Points Blocked
    Conversions Extra Points Made
    Defense Assisted Tackles
    Defense Category
    Defense Forced Fumbles
    Defense Interception
    Defense Sack
    Defense Sack Yards
    Defense Safety
    Defense Tackle For Loss
    Defense Tackles
    Field Goal Returns Category
    Field Goal Returns
    Field Goal Returns Total Yards
    Field Goal Returns Touchdowns
    Field Goals Attempt
    Field Goals Attempt Yards
    Field Goals Blocked
    Field Goals Made
    Field Goals Returned
    Field Goals Yards
    Fumble Returns Category
    Fumble Returns Fair Catches
    Fumble Returns Opponent Recovery
    Fumble Returns Own Recovery
    Fumble Returns Returns
    Fumble Returns Touchdowns
    Fumble Returns Yards
    Fumbles Category
    Fumbles Fumbles
    Fumbles Lost
    Fumbles Out Of Bounds
    Kick Returns Fair Catches
    Kick Returns Returns
    Kick Returns Touchdowns
    Kick Returns Yards
    Kickoffs End Zone
    Kickoffs Inside 20
    Kickoffs Kickoffs
    Kickoffs Net Yards
    Kickoffs Returns
    Kickoffs Touchback
    Kickoffs Yards
    Passing Attempt
    Passing Completion
    Passing First Down
    Passing Interception
    Passing Red Zone Attempts
    Passing Sack
    Passing Sack Yards
    Passing Tackled for Safety
    Passing Touchdown
    Passing Yards
    Penalties Code
    Penalties First Downs
    Penalties Yards
    Punt Returns Fair Catches
    Punt Returns Returns
    Punt Returns Touchdowns
    Punt Returns Yards
    Punting Blocked
    Punting Inside 20
    Punting Net Yards
    Punting Punts
    Punting Returns
    Punting Safety
    Punting Touchback
    Punting Yards
    Receiving First Down
    Receiving Fumbles
    Receiving Reception
    Receiving Red Zone Targets
    Receiving Target
    Receiving Touchdown
    Receiving Yards
    Rushing Attempt
    Rushing First Down
    Rushing Fumbles
    Rushing Red Zone Attempts
    Rushing Safeties
    Rushing Touchdown
    Rushing Yards
    Player Info Data Points: Full Name
    Id
    Jersey Number Position
    Team Info Data Points: Id
    > To generate the Play Summary for the play below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/min/ten/plays/0624eef2-d273-4f1b-811c-585f362a7b62.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-t1/2016/reg/1/min/ten/plays/0624eef2-d273-4f1b-811c-585f362a7b62.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-t1/2016/reg/1/min/ten/plays/0624eef2-d273-4f1b-811c-585f362a7b62.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Play Summary. https://api.sportradar.us/nfl-`{access_level}{version}`/`{year}`/`{nfl_season}`/`{week}`/`{away_team}`/`{home_team}`/plays/`{play_id}`.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `away_team` | Abbreviated team name. | | `home_team` | Abbreviated team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Play Summary, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/extended-play-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Rankings Conference and division rank for each team, including post season clinching status.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Info Data Points: Conference Id
    Conference Name
    Division Id
    Division Name
    Season Type
    Season Year
    Standings Info Data Points: Clinched Status Conference Rank Division Rank
    Team Info Data Points: Id Market Name
    > To generate the Rankings for the 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-t1/teams/2016/rankings.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-t1/teams/2016/rankings.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-t1/teams/2016/rankings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Rankings for a year. https://api.sportradar.us/nfl-`{access_level}{version}`/teams/`{year}`/rankings.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `year` | Year in 4 digit format (YYYY). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Rankings, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/rankings-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Season Schedule Provides the date, time, location, and other event details for every match-up for the season, as well as links to other feeds.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Info Data Points: Away Team Id
    Away Team Rotation Number
    Broadcast Cable
    Broadcast Internet
    Broadcast Network
    Broadcast Satellite
    Home Team Id
    Home Team Rotation Number
    Id
    Scheduled Start Date/Time
    Status
    Weather Temperature
    Weather Conditions
    Weather Humidity
    Weather Wind Speed
    Weather Wind Direction
    League Info Data Points: Bye Week Team
    Season Type
    Season Year Week Sequence
    Venue Data Points: Address
    Capacity
    City
    Country
    Id
    Name
    State
    Surface
    Type
    Zip
    > To generate Season Schedule replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/schedule.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-t1/2016/reg/schedule.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-t1/2016/reg/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Season Schedule. https://api.sportradar.us/nfl-`{access_level}{version}`/`{year}`/`{nfl_season}`/schedule.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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. | To retrieve the XML Schema Definition (.XSD) for the Season Schedule, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/schedule-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Seasonal Statistics Detailed season stats at the team and player level, including extensive offense, defense, and special teams breakouts.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Info Data Points: Season Type Season Year
    Player Info Data Points: Full Name
    Id
    Jersey Number Position
    Player Seasonal Statistics Data Points: Blocked Field Goal Return 10+ Yards
    Blocked Field Goal Return 20+ Yards
    Blocked Field Goal Return 30+ Yards
    Blocked Field Goal Return 40+ Yards
    Blocked Field Goal Return 50+ Yards
    Blocked Field Goal Return Average Yards
    Blocked Field Goal Return Longest
    Blocked Field Goal Return Returns
    Blocked Field Goal Return Touchdowns
    Blocked Field Goal Return Yards
    Conversions Extra Points Attempts
    Conversions Extra Points Blocked
    Conversions Extra Points Made
    Conversions Extra Points Percentage
    Defense 1pt Safeties
    Defense Assisted Tackles
    Defense Blocks
    Defense Combined Tackles
    Defense Conversions Attempts
    Defense Conversions Failed
    Defense Conversions Made
    Defense Fumbles Forced
    Defense Fumbles Recoveries
    Defense Fumbles Touchdowns
    Defense Interceptions
    Defense Interceptions Longest
    Defense Interceptions Touchdowns
    Defense Interceptions Yards
    Defense Miscellaneous Assisted Tackles
    Defense Miscellaneous Combined Tackles
    Defense Miscellaneous Forced Fumbles
    Defense Miscellaneous Fumble Recoveries
    Defense Miscellaneous Tackles
    Defense Passes Defended
    Defense QB Hits
    Defense Sack Yards
    Defense Sacks
    Defense Safeties
    Defense Special Teams Assisted Tackles
    Defense Special Teams Combined Tackles
    Defense Special Teams Forced Fumbles
    Defense Special Teams Fumble Recoveries
    Defense Special Teams Tackles
    Defense Tackles
    Defense Tackles For Loss
    Efficiency 3rd Down Attempts
    Efficiency 3rd Down Conversions
    Efficiency 3rd Down Conversions Via Pass
    Efficiency 3rd Down Conversions Via Penalty
    Efficiency 3rd Down Conversions Via Rush
    Efficiency 3rd Down Percentage
    Efficiency 4th Down Attempts
    Efficiency 4th Down Conversions
    Efficiency 4th Down Conversions Via Pass
    Efficiency 4th Down Conversions Via Penalty
    Efficiency 4th Down Conversions Via Rush
    Efficiency 4th Down Percentage
    Efficiency Goal To Go Attempts
    Efficiency Goal To Go Conversions
    Efficiency Goal To Go Percentage
    Efficiency Red Zone Attempts
    Efficiency Red Zone Conversions
    Efficiency Red Zone Percentage
    Field Goals Attempts
    Field Goals Attempts 1-19 Yards
    Field Goals Attempts 20-29 Yards
    Field Goals Attempts 30-39 Yards
    Field Goals Attempts 40-49 Yards
    Field Goals Attempts 50+ Yards
    Field Goals Longest
    Field Goals Made
    Field Goals Made 1-19 Yards
    Field Goals Made 20-29 Yards
    Field Goals Made 30-39 Yards
    Field Goals Made 40-49 Yards
    Field Goals Made 50+ Yards
    Field Goals Percentage
    First Downs Passing
    First Downs Penalty
    First Downs Rushing
    First Downs Total
    Fumbles Force Fumbles
    Fumbles
    Fumbles Lost Fumbles
    Fumbles Opponent Recovery
    Fumbles Opponent Recovery Touchdowns
    Fumbles Opponent Recovery Yards
    Fumbles Out of Bounds
    Fumbles Own Recovery
    Fumbles Own Recovery Touchdowns
    Fumbles Own Recovery Yards
    Games Played
    Games Started
    Kick Returns 10+ Yards
    Kick Returns 20+ Yards
    Kick Returns 30+ Yards
    Kick Returns 40+ Yards
    Kick Returns 50+ Yards
    Kick Returns Average Yards
    Kick Returns Fair Catches
    Kick Returns Longest
    Kick Returns Returns
    Kick Returns Touchdowns
    Kick Returns Yards
    Kickoffs Average Kick
    Kickoffs Average Return
    Kickoffs End Zone
    Kickoffs Inside 20
    Kickoffs Inside 20 Percentage
    Kickoffs
    Kickoffs Longest
    Kickoffs Net Average
    Kickoffs Net Yards
    Kickoffs Return Yards
    Kickoffs Returns
    Kickoffs Touchback Percentage
    Kickoffs Touchbacks
    Kickoffs Yards
    Passing 10+ Yards
    Passing 20+ Yards
    Passing 30+ Yards
    Passing 40+ Yards
    Passing 50+ Yards
    Passing Attempts
    Passing Average Yards
    Passing Average Yards Per Completion
    Passing Completion Percentage
    Passing Completions
    Passing First Downs
    Passing Interception Percentage
    Passing Interceptions
    Passing Ints Returned for Touchdown
    Passing Longest
    Passing Rating
    Passing Red Zone Attempts
    Passing Sack Yards
    Passing Sacks
    Passing Safeties
    Passing Touchdowns
    Passing Touchdowns Percentage
    Passing Yards
    Penalties
    Penalties Penalty First Downs
    Penalties Penalty Yards
    Punt Returns 10+ Yards
    Punt Returns 20+ Yards
    Punt Returns 30+ Yards
    Punt Returns 40+ Yards
    Punt Returns 50+ Yards
    Punt Returns Average Yards
    Punt Returns Fair Catches
    Punt Returns Longest
    Punt Returns Returns
    Punt Returns Touchdowns
    Punt Returns Yards
    Punts Attempts
    Punts Average Net Yards
    Punts Average Return
    Punts Average Yards
    Punts Blocked
    Punts Inside 20
    Punts Inside 20 Percentage
    Punts Longest
    Punts Net Yards
    Punts Return Yards
    Punts Returns
    Punts Safeties
    Punts Touchback Percentage
    Punts Touchbacks
    Punts Yards
    Receiving 10+ Yards
    Receiving 20+ Yards
    Receiving 30+ Yards
    Receiving 40+ Yards
    Receiving 50+ Yards
    Receiving Average Yards
    Receiving First Downs
    Receiving Fumbles
    Receiving Longest
    Receiving Receptions
    Receiving Red Zone Targets
    Receiving Targets
    Receiving Touchdowns
    Receiving Yards
    Receiving Yards After Catch
    Rushing 10+ Yards
    Rushing 20+ Yards
    Rushing 30+ Yards
    Rushing 40+ Yards
    Rushing 50+ Yards
    Rushing Attempts
    Rushing Average Yards
    Rushing First Down Percentage
    Rushing First Downs
    Rushing Fumbles
    Rushing Longest
    Rushing Red Zone Attempts
    Rushing Safeties
    Rushing Touchdowns
    Rushing Yards
    Touchdowns Field Goal Return
    Touchdowns Fumble Return
    Touchdowns Interception Return
    Touchdowns Kick Return
    Touchdowns Other
    Touchdowns Pass
    Touchdowns Punt Return
    Touchdowns Rush
    Two Point Conversions Attempted
    Two Point Conversions Made
    Two Point Conversions Passing
    Two Point Conversions Receiving
    Two Point Conversions Rushing
    Team Seasonal Statistics Data Points: Blocked Field Goal Return 10+ Yards
    Blocked Field Goal Return 20+ Yards
    Blocked Field Goal Return 30+ Yards
    Blocked Field Goal Return 40+ Yards
    Blocked Field Goal Return 50+ Yards
    Blocked Field Goal Return Average Yards
    Blocked Field Goal Return Longest
    Blocked Field Goal Return Returns
    Blocked Field Goal Return Touchdowns
    Blocked Field Goal Return Yards
    Conversions Extra Points Attempts
    Conversions Extra Points Blocked
    Conversions Extra Points Made
    Conversions Extra Points Percentage
    Defense 1pt Safeties
    Defense Assisted Tackles
    Defense Blocks
    Defense Combined Tackles
    Defense Conversions Attempts
    Defense Conversions Failed
    Defense Conversions Made
    Defense Fumbles Forced
    Defense Fumbles Recoveries
    Defense Fumbles Touchdowns
    Defense Interceptions
    Defense Interceptions Longest
    Defense Interceptions Touchdowns
    Defense Interceptions Yards
    Defense Miscellaneous Assisted Tackles
    Defense Miscellaneous Combined Tackles
    Defense Miscellaneous Forced Fumbles
    Defense Miscellaneous Fumble Recoveries
    Defense Miscellaneous Tackles
    Defense Passes Defended
    Defense QB Hits
    Defense Sack Yards
    Defense Sacks
    Defense Safeties
    Defense Special Teams Assisted Tackles
    Defense Special Teams Combined Tackles
    Defense Special Teams Forced Fumbles
    Defense Special Teams Fumble Recoveries
    Defense Special Teams Tackles
    Defense Tackles
    Defense Tackles For Loss
    Efficiency 3rd Down Attempts
    Efficiency 3rd Down Conversions
    Efficiency 3rd Down Conversions Via Pass
    Efficiency 3rd Down Conversions Via Penalty
    Efficiency 3rd Down Conversions Via Rush
    Efficiency 3rd Down Percentage
    Efficiency 4th Down Attempts
    Efficiency 4th Down Conversions
    Efficiency 4th Down Conversions Via Pass
    Efficiency 4th Down Conversions Via Penalty
    Efficiency 4th Down Conversions Via Rush
    Efficiency 4th Down Percentage
    Efficiency Goal To Go Attempts
    Efficiency Goal To Go Conversions
    Efficiency Goal To Go Percentage
    Efficiency Red Zone Attempts
    Efficiency Red Zone Conversions
    Efficiency Red Zone Percentage
    Field Goals Attempts
    Field Goals Attempts 1-19 Yards
    Field Goals Attempts 20-29 Yards
    Field Goals Attempts 30-39 Yards
    Field Goals Attempts 40-49 Yards
    Field Goals Attempts 50+ Yards
    Field Goals Longest
    Field Goals Made
    Field Goals Made 1-19 Yards
    Field Goals Made 20-29 Yards
    Field Goals Made 30-39 Yards
    Field Goals Made 40-49 Yards
    Field Goals Made 50+ Yards
    Field Goals Percentage
    First Downs Passing
    First Downs Penalty
    First Downs Rushing
    First Downs Total
    Fumbles Force Fumbles
    Fumbles
    Fumbles Lost Fumbles
    Fumbles Opponent Recovery
    Fumbles Opponent Recovery Touchdowns
    Fumbles Opponent Recovery Yards
    Fumbles Out Of Bounds
    Fumbles Own Recovery
    Fumbles Own Recovery Touchdowns
    Fumbles Own Recovery Yards
    Kick Returns 10+ Yards
    Kick Returns 20+ Yards
    Kick Returns 30+ Yards
    Kick Returns 40+ Yards
    Kick Returns 50+ Yards
    Kick Returns Average Yards
    Kick Returns Fair Catches
    Kick Returns Longest
    Kick Returns
    Kick Returns Touchdowns
    Kick Returns Yards
    Kickoffs Average Kick
    Kickoffs Average Return
    Kickoffs End Zone
    Kickoffs Inside 20
    Kickoffs Inside 20 Percentage
    Kickoffs
    Kickoffs Longest
    Kickoffs Net Average
    Kickoffs Net Yards
    Kickoffs Return Yards
    Kickoffs Returns
    Kickoffs Touchback Percentage
    Kickoffs Touchbacks
    Kickoffs Yards
    Passing 10+ Yards
    Passing 20+ Yards
    Passing 30+ Yards
    Passing 40+ Yards
    Passing 50+ Yards
    Passing Attempts
    Passing Average Yards
    Passing Average Yards Per Completion
    Passing Completion Percentage
    Passing Completions
    Passing First Downs
    Passing Interception Percentage
    Passing Interceptions
    Passing Ints Returned For Touchdown
    Passing Longest
    Passing Rating
    Passing Red Zone Attempts
    Passing Sack Yards
    Passing Sacks
    Passing Safeties
    Passing Touchdowns
    Passing Touchdowns Percentage
    Passing Yards
    Penalties
    Penalties Penalty First Downs
    Penalties Penalty Yards
    Punt Returns 10+ Yards
    Punt Returns 20+ Yards
    Punt Returns 30+ Yards
    Punt Returns 40+ Yards
    Punt Returns 50+ Yards
    Punt Returns Average Yards
    Punt Returns Fair Catches
    Punt Returns Longest
    Punt Returns Returns
    Punt Returns Touchdowns
    Punt Returns Yards
    Punts Attempts
    Punts Average Net Yards
    Punts Average Return
    Punts Average Yards
    Punts Blocked
    Punts Inside 20
    Punts Inside 20 Percentage
    Punts Longest
    Punts Net Yards
    Punts Return Yards
    Punts Returns
    Punts Safeties
    Punts Touchback Percentage
    Punts Touchbacks
    Punts Yards
    Receiving 10+ Yards
    Receiving 20+ Yards
    Receiving 30+ Yards
    Receiving 40+ Yards
    Receiving 50+ Yards
    Receiving Average Yards
    Receiving First Downs
    Receiving Fumbles
    Receiving Longest
    Receiving Receptions
    Receiving Red Zone Targets
    Receiving Targets
    Receiving Touchdowns
    Receiving Yards
    Receiving Yards After Catch
    Rushing 10+ Yards
    Rushing 20+ Yards
    Rushing 30+ Yards
    Rushing 40+ Yards
    Rushing 50+ Yards
    Rushing Attempts
    Rushing Average Yards
    Rushing First Down Percentage
    Rushing First Downs
    Rushing Fumbles
    Rushing Longest
    Rushing Red Zone Attempts
    Rushing Safeties
    Rushing Touchdowns
    Rushing Yards
    Touchdowns Field Goal Return
    Touchdowns Fumble Return
    Touchdowns Interception Return
    Touchdowns Kick Return
    Touchdowns Other
    Touchdowns Pass
    Touchdowns Punt Return
    Touchdowns Rush
    Two Point Conversions Attempted
    Two Point Conversions Made
    Two Point Conversions Passing
    Two Point Conversions Receiving
    Two Point Conversions Rushing
    Team Info Data Points: Id Market Name
    > To generate the Seasonal Statistics for the Team, 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-t1/teams/min/2015/REG/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-t1/teams/min/2015/REG/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-t1/teams/min/2015/REG/statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Seasonal Statistics. https://api.sportradar.us/nfl-`{access_level}{version}`/teams/`{team}`/`{year}`/`{nfl_season}`/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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `team` | Abbreviated team name. | | `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. | To retrieve the XML Schema Definition (.XSD) for the Seasonal Statistics, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/statistics-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Standings Detailed information on wins and losses, broken down by conference, division, and various scenarios.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Info Data Points: Conference Id
    Conference Name
    Division Id
    Division Name
    Season Type
    Season Year
    Standings Data Points: Away Losses
    Away Ties
    Away Winning Perc
    Away Wins
    Conference Losses
    Conference Ties
    Conference Winning Perc
    Conference Wins
    Decided By 7pts Losses
    Decided By 7pts Ties
    Decided By 7pts Winning Perc
    Decided By 7pts Wins
    Division Losses
    Division Ties
    Division Winning Perc
    Division Wins
    Grass Losses
    Grass Ties
    Grass Winning Perc
    Grass Wins
    Home Losses
    Home Ties
    Home Winning Perc
    Home Wins
    Last 5 Games Losses
    Last 5 Games Ties
    Last 5 Games Winning Perc
    Last 5 Games Wins
    Leading At Half Losses
    Leading At Half Ties
    Leading At Half Winning Perc
    Leading At Half Wins
    Non-Conference Losses
    Non-Conference Ties
    Non-Conference Winning Perc
    Non-Conference Wins
    Overall Losses
    Overall Net Points
    Overall Points Against
    Overall Points For
    Overall Ties
    Overall Winning Perc
    Overall Wins
    Overtime Losses
    Overtime Ties
    Overtime Winning Perc
    Overtime Wins
    Streak Number
    Streak Type
    Touchdowns Against
    Touchdowns For
    Turf Losses
    Turf Ties
    Turf Winning Perc
    Turf Wins
    When Scoring First Losses
    When Scoring First Ties
    When Scoring First Winning Perc
    When Scoring First Wins
    Team Info Data Points: Id Market Name
    > To generate the Standings enter the Year and Season below, and replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/teams/2015/REG/standings.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-t1/teams/2015/REG/standings.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-t1/teams/2015/REG/standings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Standings. https://api.sportradar.us/nfl-`{access_level}{version}`/teams/`{year}`/`{nfl_season}`/standings.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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. | To retrieve the XML Schema Definition (.XSD) for the Standings, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/standings-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Team Depth Chart Depth chart rankings for every position.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Depth Charts Data Points: Defense Type
    Depth Chart Position
    Position Description Position Name
    Player Info Data Points: Full Name
    Id
    Jersey Number
    Position
    Status
    Team Info Data Points: Id Market Name
    > To generate the Team Depth Chart for the team below, and replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/teams/min/depthchart.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-t1/teams/min/depthchart.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-t1/teams/min/depthchart.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Team Depth Charts. https://api.sportradar.us/nfl-`{access_level}{version}`/teams/`{team}`/depthchart.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `team` | Abbreviated team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Depth Chart, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/depth_chart-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Team Hierarchy Conference, division, and team identification and association information.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Info Data Points: Conference Id
    Conference Name
    Division Id
    Division Name
    Id
    Team Info Data Points: Id Market Name
    Venue Data Points: Address
    Capacity
    City
    Country
    Id
    Name
    State
    Surface
    Type
    Zip
    > To generate the Team Hierarchy replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/teams/hierarchy.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-t1/teams/hierarchy.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-t1/teams/hierarchy.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Team Hierarchy feed by replacing the parameters in the following URL: https://api.sportradar.us/nfl-`{access_level}{version}`/teams/hierarchy.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `format` | xml or json. | | `your_api_key` | Your API key. | Return to API map ## Team Roster Player information for a team, including height/weight, jersey number, position, and injury status.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Injuries Data Points: Description
    Game Status
    Id
    Practice Status
    Start Date
    Player Info Data Points: Abbreviated Name
    Birth Date
    Birth Place
    College
    Draft Info Draft Pick
    Draft Info Round
    Draft Info Year
    Draft Info Team
    Experience
    First Name
    Full Name
    Height
    High School
    Id
    Jersey Number
    Last Name
    Position
    Salary
    Status
    Weight
    Team Info Data Points: Coach Abbreviated Name
    Coach First Name
    Coach Full Name
    Coach Id
    Coach Last Name
    Coach Position
    Coach Salary
    Coach Status
    Id
    Market
    Name
    > To generate the Team Roster replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/teams/min/roster.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-t1/teams/min/roster.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-t1/teams/min/roster.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Team Roster feed by replacing the parameters in the following URL: https://api.sportradar.us/nfl-`{access_level}{version}`/teams/`{team}`/roster.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 1). | | `team` | Abbreviated team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | Return to API map ## Weekly Boxscore Top-level team scores by quarter, for all games in the given week.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Boxscore Data Points: Away Team Challenges Remaining
    Away Team Points for Quarter
    Away Team Timeouts Remaining
    Away Team Total Points
    Clock
    Home Team Challenges Remaining
    Home Team Points For Quarter
    Home Team Timeouts Remaining
    Home Team Total Points
    Quarter
    Quarter Number
    Scoring Away Team Points
    Scoring Clock
    Scoring Drive Quarter
    Scoring Drive Sequence
    Scoring Drive Starting Game Clock
    Scoring Drive Team Id
    Scoring Home Team Points
    Scoring Play Description
    Scoring Play Id
    Scoring Play Type
    Scoring Points
    Scoring Quarter
    Scoring Team Id
    Game Info Data Points: Away Team Id
    Away Team Market
    Away Team Name
    Completion Date/Time
    Home Team Id
    Home Team Market
    Home Team Name
    Id
    Scheduled Start Date/Time
    Status
    League Info Data Points: Season Type Season Year Week Sequence
    Team Data Points: Id Market Name
    > To generate the Weekly Boxscore replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/boxscore.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-t1/2016/reg/1/boxscore.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-t1/2016/reg/1/boxscore.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Weekly Boxscore feed by replacing the parameters in the following URL: https://api.sportradar.us/nfl-`{access_level}{version}`/`{year}`/`{nfl_season}`/`{week}`/boxscore.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Weekly Boxscore, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/boxscore-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Weekly League Leaders Provides the league leaders, and their corresponding stats, for the categories of passing, rushing, receiving, and kicking (field goals & extra points).
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Player Game Statistics Data Points: Conversions Extra Points Attempts
    Conversions Extra Points Blocked
    Conversions Extra Points Made
    Conversions Extra Points Percentage
    Field Goals Attempts
    Field Goals Attempts 1-19 Yards
    Field Goals Attempts 20-29 Yards
    Field Goals Attempts 30-39 Yards
    Field Goals Attempts 40-49 Yards
    Field Goals Attempts 50+ Yards
    Field Goals Blocked
    Field Goals Longest
    Field Goals Made
    Field Goals Made 1-19 Yards
    Field Goals Made 20-29 Yards
    Field Goals Made 30-39 Yards
    Field Goals Made 40-49 Yards
    Field Goals Made 50+ Yards
    Field Goals Percentage
    Passing 10+ Yards
    Passing 20+ Yards
    Passing 30+ Yards
    Passing 40+ Yards
    Passing 50+ Yards
    Passing Attempts
    Passing Average Yards
    Passing Average Yards Per Completion
    Passing Completion Percentage
    Passing Completions
    Passing First Downs
    Passing Interception Percentage
    Passing Interceptions
    Passing Ints Returned For Touchdown
    Passing Longest
    Passing Rating
    Passing Red Zone Attempts
    Passing Sack Yards
    Passing Sacks
    Passing Safeties
    Passing Touchdowns
    Passing Touchdowns Percentage
    Passing Yards
    Receiving 10+ Yards
    Receiving 20+ Yards
    Receiving 30+ Yards
    Receiving 40+ Yards
    Receiving 50+ Yards
    Receiving Average Yards
    Receiving First Downs
    Receiving Fumbles
    Receiving Longest
    Receiving Receptions
    Receiving Red Zone Targets
    Receiving Targets
    Receiving Touchdowns
    Receiving Yards
    Receiving Yards After Catch
    Rushing 10+ Yards
    Rushing 20+ Yards
    Rushing 30+ Yards
    Rushing 40+ Yards
    Rushing 50+ Yards
    Rushing Attempts
    Rushing Average Yards
    Rushing First Down Percentage
    Rushing First Downs
    Rushing Fumbles
    Rushing Longest
    Rushing Red Zone Attempts
    Rushing Safeties
    Rushing Touchdowns
    Rushing Yards
    League Info Data Points: Season Type Season Year Week Sequence
    Player Info Data Points: Full Name
    Id
    Jersey Number Position
    Team Info Data Points: Id Market Name
    > To generate the Weekly League Leaders replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/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-t1/2016/reg/1/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-t1/2016/reg/1/leaders.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Weekly League Leaders feed by replacing the parameters in the following URL: https://api.sportradar.us/nfl-`{access_level}{version}`/`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Weekly League Leaders, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/statistics-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Weekly Schedule Provides the date, time, location, and other event details for every match-up for the week, as well as links to other feeds.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Info Data Points: Away Team Id
    Away Team Rotation Number
    Broadcast Cable
    Broadcast Internet
    Broadcast Network
    Broadcast Satellite
    Home Team Id
    Home Team Rotation Number
    Id
    Scheduled Start Date/Time
    Status
    Weather Temperature
    Weather Conditions
    Weather Humidity
    Weather Wind Speed
    Weather Wind Direction
    League Info Data Points: Season Type Season Year Week Sequence
    Venue Data Points: Address
    Capacity
    City
    Country
    Id
    Name
    State
    Surface
    Type
    Zip
    > To generate the Weekly Schedule replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-t1/2016/reg/1/schedule.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-t1/2016/reg/1/schedule.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-t1/2016/reg/1/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. Access the Weekly Schedule feed by replacing the parameters in the following URL: https://api.sportradar.us/nfl-`{access_level}{version}`/`{year}`/`{nfl_season}`/`{week}`/schedule.`{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 Real-Time (rt), Premium (p), Standard (s), Basic (b), or Trial (t). | | `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 of season 1 - 17 (Week 0 of Preseason is Hall of Fame game). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Weekly Schedule, replace the parameters in the following URL. https://api.sportradar.us/nfl-`{access_level}{version}`/schema/schedule-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## 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 possible game types and their descriptions?

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

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

    Q: What are the possible season types and their descriptions?

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

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

    Q: What are the valid game statuses and their definitions?

    A: Here are the valid game statuses and their descriptions:

    • scheduled - The game is scheduled to occur.
    • created – We are ready to begin recording actions against a scheduled game.
    • inprogress – The game is in progress.
    • complete – The game is over, but stat validation is not complete.
    • closed – The game is over and the stats have been validated.
    • reopened – The game stats are in the process of being corrected.
    • delayed – The start of the game has been delayed, or a game that was in progress is currently delayed.
    • flex-schedule – The game is currently scheduled to occur on a specific date and time, however, it will more than likely be moved to a different time for broadcast purposes.
    • time-tbd – The game is scheduled to occur on a specific date, but the specific time it not available.

    Q: What are the valid player statuses and their definitions?

    A: Here are the valid player status and their descriptions:

    • ACT – Active
    • DUP - Duplicate
    • EXE – Exempt
    • IR – Injured Reserve
    • IRD – Injured Reserve – Designated for Return
    • NON – Non football related injured reserve
    • NWT – Not with Team
    • PRA – Practice Squad
    • PUP – Physically unable to perform
    • RET - Retired
    • SUS – Suspended
    • UDF – Unsigned draft pick

    Q: What are the valid player game statuses and their definitions?

    A: Here are the valid player game statuses and their descriptions:

    • DOU – Doubtful
    • OUT – Out of game
    • PRO – Probable (No longer used as of the 2016 season)
    • QST – Questionable
    • UNK – Unknown or no player status available

    Q: What are the valid player practice statuses and their definitions?

    A: Here are the valid player practice statuses and their descriptions:

    • Did Not Participate – The player did not participate in practice
    • Limited Participation – The player practiced, but his activities were limited
    • Full Participation – The player participated in practice

    Q: What are the event types we track?

    A: The valid event types are:

    • cointoss
    • teamtimeout
    • injurytimeout – Note: This status is not currently used for NFL games.
    • tvtimeout
    • challenge
    • review
    • quarterend
    • twominuteswarning
    • miscnote
    • gameover

    Q: What are the score types we track in the Game Boxscore?

    A: The valid score types are:

    • touchdown
    • extrapoint
    • conversion
    • fieldgoal
    • safety

    Q: What are the play types we track?

    A: The valid play types are:

    • penalty
    • kick
    • punt
    • rush
    • pass
    • fieldgoal
    • extrapoint

    Q: What are the various penalty codes and their definitions?

    A: Here are the penalty codes and their corresponding definitions:

    Defense Offense
    dtm - 12 men in the huddle otm - 12 men in the huddle
    d12 - 12 players o12 - 12 players
    dpb - Batting or punching a loose ball ol7 - Less than seven men on offensive line at snap
    dnc - Captains not appearing for coin toss ofr - A punter placekicker or holder who fakes being roughed
    dcw - Clipping onc - Captains not appearing for coin toss
    dds - Delay of game at start of either half ocb - Chop block
    ddg - Delay of game ocw - Clipping
    ddk - Delay of kickoff ods - Delay of game at start of either half
    den - Encroachment odg - Delay of game
    dec - Excessive crowd noise odk - Delay of kickoff
    det - Excessive time outs oec - Excessive crowd noise
    dfm - Facemask Incidental oet - Excessive time outs
    dgf - Facemasking ball carrier or quarterback ofm - Facemask Incidental
    daf - Facemasking oaf - Facemasking
    dfi - Fair catch interference ore - Failure to report change of eligibility
    dfo - Helmet off ofs - False start
    dsp - Helmet to butt spear or ram ooo - First onside kickoff out of bounds
    duh - Holding ofo - Helmet off
    dih - Illegal use of hands ofk - Offside on Free Kick
    dhc - Horse Collar osp - Helmet to butt spear or ram
    dic - Illegal Contact ohr - Helping the runner
    dib - Illegal block in the back ouh - Holding
    dif - Illegal formation oih - Illegal use of hands
    dlb - Illegal low block ohc - Horse Collar
    dkb - Kicking a loose ball ops - Illegal Forward Pass
    dko - Kicking or kneeing opponent opb - Forward pass thrown from beyond line of scrimmage
    dlp - Leaping oip - Illegal Procedure
    dlv - Leverage oib - Illegal block in the back
    dnz - Neutral zone infraction oic - Illegal crackback block by offense
    dof - Offside oif - Illegal formation
    dpu - Palpably unfair act olb - Illegal low block
    dpi - Pass interference oim - Illegal motion
    dpf - Personal Foul oir - Illegal return
    dpo - Piling on ois - Illegal shift
    dob - Player out of bounds at snap oiu - Illegal substitution
    drc - Roughing the kicker oid - Ineligible member kicking team beyond scrimmage
    drp - Roughing the passer opd - Ineligible player downfield during passing down
    dhk - Running into kicker oig - Intentional grounding
    dso - Striking opponent on head or neck ofc - Invalid fair catch signal
    dsf - Striking opponent with fist okb - Kicking a loose ball
    dho - Striking or shoving a game official okk - Kicking or kneeing opponent
    dtn - Taunting oko - Kicking team player out of bounds
    dla – Team’s late arrival on the field prior to scheduled kickoff olp - Leaping
    dtr - Tripping olv - Leverage
    dur - Unnecessary roughness onz - Neutral zone infraction
    duc - Unsportsmanlike conduct oof - Offside
    dhw - Using a helmet (not worn) as a weapon opu - Palpably unfair act
    dth - Using top of his helmet unnecessarily opi - Pass interference
    ddq - Defensive disqualification oto - Pass touched by receiver who went OOB
    ori - Pass touched or caught by ineligible receiver
    opf - Personal Foul
    opo - Piling on
    oob - Player out of bounds at snap
    oso - Striking opponent on head or neck
    osf - Striking opponent with fist
    oho - Striking or shoving a game official
    otn - Taunting
    ola - Teamís late arrival on the field prior to scheduled kickoff
    otr - Tripping
    our - Unnecessary roughness
    ouc - Unsportsmanlike conduct
    ohw - Using a helmet (not worn) as a weapon
    oth - Using top of his helmet unnecessarily
    oit - Illegal touch kick
    odq - Offensive disqualification

    Q: What are the possible player positions and their definitions?

    A: Here are the possible player positions:

    Offense

    • C - Center
    • FB - Fullback
    • G - Offensive Guard
    • OG - Offensive Guard
    • OL - Offensive Lineman
    • OT - Offensive Tackle
    • QB - Quarterback
    • RB - Running Back
    • T - Offensive Tackle
    • TE - Tight End
    • WR - Wide Receiver

    Defense

    • CB - Cornerback
    • DB - Defensive Back
    • DE - Defensive End
    • DT - Defensive Tackle
    • FS - Free Safety
    • LB – Linebacker
    • MLB - Middle Linebacker
    • NT - Nose Tackle
    • OLB - Outside Linebacker
    • SAF - Safety
    • SS - Strong Safety

    Special Teams

    • K - Kicker
    • LS - Long Snapper
    • P - Punter

    Q: What are the possible depth chart positions and their definitions?

    A: Here are the possible depth chart positions:

    Offense

    • C - Center
    • FB - Fullback
    • LG - Left Guard
    • LT - Left Tackle
    • QB - Quarterback
    • RB - Running Back
    • RG - Right Guard
    • RT - Right Tackle
    • TE - Tight End
    • WR - Wide Receiver

    Defense

    • CB - Cornerback
    • FS - Free Safety
    • LDE - Left Defensive End
    • LDT - Left Defensive Tackle
    • LILB - Left Inside Linebacker
    • LOLB - Left Outside Linebacker
    • MLB - Middle Linebacker
    • NT - Nose Tackle
    • RDE - Right Defensive End
    • RDT- Right Defensive Tackle
    • RILB - Right Inside Linebacker
    • ROLB - Right Outside Linebacker
    • SLB – Strong Side Linebacker
    • SS - Strong Safety
    • WLB – Weak Side Linebacker

    Special Teams

    • H – Holder
    • KR - Kick Returner
    • LS - Long Snapper
    • P - Punter
    • PK - Place Kicker
    • PR - Punt Returner

    Q: What are the possible playoff statuses and their definitions?

    A: Here are the possible playoff statuses and their definitions:

    • division - The team has clinched the division.
    • division_homefield – The team has clinched the division and home field advantage for the playoffs.
    • playoff_berth – The team has clinched a playoff berth.
    • wildcard – The team has clinched the wildcard berth.

    Q: How are assisted tackles handled?

    A: Our live data entry personnel strive to log assisted tackles as they see them, but may not log every assist. Furthermore, we do not validate our assisted tackles information against external sources.

    Return to top