NCAA Mens Football v1

Frequently Asked Questions
API API Version Data Entry Workflow
NCAA Football v1 Data Entry Workflow
Note: Authentication is required for all API calls.
## NCAA Football API Map To best utilize the NCAA Football 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 a teams passing interception percentage for the season: >
  1. Call the season or weekly schedule and find abbreviated team name
  2. Call the Seasonal Statistics using the abbreviated team name
  3. Find the Passing element with the interception percentage attribute
>The teams passing interception percentage is displayed. >
    >To find the starting yard line for a specific play: >
    1. Call the season or weekly schedule and find abbreviated team names for the game you want
    2. Call the Play-By-Play using the team names
    3. Find the Play element with the Id of the play you want
    4. Call the Play Summary for the play id you want and find the Starting Situation element with the yard line attribute
    >The starting yard line for specified play is displayed. The primary feeds provide season weeks and team aliases for the game and team feeds. All feeds aside from the Play Summary require only dates or human-readable parameters. The Play Summary requires a global unique identifier (GUID) to identify the play that the feed will discribe. ## Coverage Levels We provide two different levels of detail to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible. The coverage level for games are listed in the schedule feeds. Extended Boxscore - For any game involving an FBS (Division I-A) team, which we are not covering via full coverage, we will provide scores, time remaining, and team leaders (passing, rushing, and receiving), in a timely manner, as the game progresses. We will provide team and player level data for the game within 60 minutes of the official results being posted. For any game involving an FCS (Division-IAA) team, will provide scores and time remaining, in a timely manner, as the game progresses. We will provide team and player level data for the game by the close of business on the following Monday. Full - We provide live play-by-play coverage for the entire game. We provide updated scores and time remaining as well as team and player level data in near real time. Full coverage is available for any game involving an FBS (Division I-A) team and is available via a reliable video broadcast.
    Note: Coverage levels may be adjusted up to the scheduled start time at the discretion of our data entry managers for such reasons as resource availability as well as possible broadcast and technical difficulties.
    Due to the differences between available coverage levels, we recommend using specific game centric feeds based on the coverage level.
    Feeds
    Full
    Extended Boxscore
    Pre-Game
    In Progress
    Post Game
    Boxscore
    X
    X
    X
    Extended Boxscore
    X
    X
    X
    Game Roster
    X
    X
    X
    Game Statistics
    X
    X
    Game Summary
    X
    X
    Play-By-Play
    X
    Play Summary
    X
    Note: All FCS Playoff games will be covered via our Full coverage level.
    ## Boxscore Top-level team scores by quarter.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Info Data Points: Attendance
    Away Team Id
    Clock Time
    Completion Time
    Home Team Id
    Id
    Points By Quarter
    Quarter
    Remaining Challenges
    Remaining Timeouts
    Scheduled Kickoff
    Status
    Total Points Scored By Team
    Team Info Data Points: Id Market Name
    > 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/ncaafb-t1/2015/REG/12/TOL/BGN/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", "/ncaafb-t1/2015/REG/12/TOL/BGN/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/ncaafb-t1/2015/REG/12/TOL/BGN/boxscore.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Boxscore for a game. https://api.sportradar.us/ncaafb-`{access_level}{version}`/`{season_year}`/`{ncaafb_season}`/`{ncaafb_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). | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `ncaafb_season_week` | Number of weeks into the season in 2 digit format (WW). | | `away_team` | Abbreviated team name in 2 or 3 letter format. | | `home_team` | Abbreviated team name in 2 or 3 letter format. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Boxscore, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{access_level}{version}`/schema/boxscore-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## 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
    Game Info Data Points: Attendance
    Away Team Id
    Clock Time
    Completion Time
    Home Team Id
    Id
    Last Event Clock
    Last Event Description
    Last Event Sequence
    Last Event Type
    Last Event Updated
    Points By Quarter
    Possession Down
    Possession Team
    Possession Time
    Posession Side
    Posession Yard Line
    Possession Yards For Down
    Quarter
    Remaining Challenges
    Remaining Timeouts
    Scheduled Kickoff
    Status
    Total Points Scored By Team
    Offense Data Points: Passing Attempts
    Passing Avg. Yards Per Completion
    Passing Avg. Yards Per Pass Attempt
    Passing Completion Percentage
    Passing Completions
    Passing Interception Percentage
    Passing Interceptions
    Passing Longest Pass
    Passing Rating
    Passing Total Yards
    Passing Touchdown Percentage
    Passing Touchdowns
    Receiving Average Reception
    Receiving Longest Reception
    Receiving Receptions
    Receiving Total Yards
    Receiving Touchdowns
    Rushing Attempts
    Rushing Average Rush
    Rushing Longest Rush
    Rushing Total Yards
    Rushing Touchdowns
    Time Of Possession
    Team Info Data Points: Id Market Name
    > To generate the Extended 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/ncaafb-t1/2015/REG/12/TOL/BGN/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", "/ncaafb-t1/2015/REG/12/TOL/BGN/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/ncaafb-t1/2015/REG/12/TOL/BGN/extended-boxscore.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the extended Boxscore for a game. https://api.sportradar.us/ncaafb-`{access_level}{version}`/`{season_year}`/`{ncaafb_season}`/`{ncaafb_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). | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `ncaafb_season_week` | Number of weeks into the season in 2 digit format (WW). | | `away_team` | Abbreviated team name in 2 or 3 letter format. | | `home_team` | Abbreviated team name in 2 or 3 letter format. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Boxscore, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{access_level}{version}`/schema/extended-boxscore-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Game Roster Player information for each matchup, including height/weight, jersey number, and position.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Info Data Points: Away Team Id
    Home Team Id
    Id
    Scheduled Kickoff
    Status
    Offense Data Point: Games Played
    Player Info Data Points: Abbreviated Name
    Date Of Birth
    First Name
    Full Name
    Height
    Id
    Jersey Number
    Last Name
    Position
    Status
    Weight
    Coach Info Data Points: Abbreviated Name
    First Name
    Full Name
    Id
    Last Name
    Position
    Salary
    Status
    Team Data Points: 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/ncaafb-t1/2015/REG/12/TOL/BGN/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", "/ncaafb-t1/2015/REG/12/TOL/BGN/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/ncaafb-t1/2015/REG/12/TOL/BGN/roster.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Game Roster. https://api.sportradar.us/ncaafb-`{access_level}{version}`/`{season_year}`/`{ncaafb_season}`/`{ncaafb_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). | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `ncaafb_season_week` | Number of weeks into the season in 2 digit format (WW). | | `away_team` | Abbreviated team name in 2 or 3 letter format. | | `home_team` | Abbreviated team name in 2 or 3 letter format. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Game Roster, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{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 extensive breakouts for offense, defense, and special teams.
    Update Frequency: As Necessary
    Content Type: Raw XML or JSON
    Game Info Data Points: Attendance
    Away Team Id
    Home Team Id
    Id
    Remaining Challenges
    Remaining Timeouts
    Scheduled Kickoff
    Status
    Total Points Scored By Team
    Defense Data Points: Blocked Kicks
    Forced Fumbles
    Fumbles Recovered
    Fumbles Recovered For Touchdowns
    Interceptions
    Longest Interception
    Touchdowns From Interceptions
    Yards From Interceptions
    Misc. Assisted tackles
    Misc. Combined tackles
    Misc. Forced Fumbles
    Misc. Fumbles Recovered
    Misc. Tackles
    Passes Defended
    Quarterback Hits
    Total Sacks
    Yards From Sacks
    Safeties
    Special Teams Assisted Tackles
    Special Teams Combined Tackles
    Special Teams Forced Fumbles
    Special Teams Fumbles Recovered
    Special Teams Total Tackles
    Assisted Tackles
    Combined Tackles
    Tackles For A Loss
    Total Tackles
    Offense Data Points: 3rd Down Conversion Attempts
    3rd Down Conversion Converted
    3rd Down Conversion Percentage
    3rd Down Conversion Via Pass
    3rd Down Conversion Via Penalty
    3rd Down Conversion Via Rush
    4th Down Conversion Attempts
    4th Down Conversion Converted
    4th Down Conversion Percentage
    4th Down Conversion Via Pass
    4th Down Conversion Via Penalty
    4th Down Conversion Via Rush
    Goal Efficiency Attempts
    Goal Efficiency Percentage
    Goal Efficiency Touchdowns
    Passing 10+ Yards
    Passing 20+ Yards
    Passing 30+ Yards
    Passing 40+ Yards
    Passing 50+ Yards
    Passing Attempts
    Passing Avg. Yards Per Completion
    Passing Avg. Yards Per Pass Attempt
    Passing Completion Percentage
    Passing Completions
    Passing First Downs
    Passing Interception Percentage
    Passing Interceptions
    Passing Interceptions Returned For TD
    Passing Longest Pass
    Passing Rating
    Passing Red Zone Attempts
    Passing Sacked
    Passing Sacked Yards Lost
    Passing Tackled For Safety
    Passing Total Yards
    Passing Touchdown Percentage
    Passing Touchdowns
    Receiving 10+ Yards
    Receiving 20+ Yards
    Receiving 30+ Yards
    Receiving 40+ Yards
    Receiving 50+ Yards
    Receiving Average Reception
    Receiving First Downs
    Receiving Fumbled On Reception
    Receiving Longest Reception
    Receiving Receptions
    Receiving Red Zone Targets
    Receiving Target
    Receiving Total Yards
    Receiving Touchdowns
    Receiving Yards After Completion
    Red Zone Efficiency Attempts
    Red Zone Efficiency Conversions
    Red Zone Efficiency Percentage
    Rushing 10+ Yards
    Rushing 20+ Yards
    Rushing 30+ Yards
    Rushing 40+ Yards
    Rushing 50+ Yards
    Rushing Attempts
    Rushing Average Rush
    Rushing First Down Percentage
    Rushing First Downs
    Rushing Fumbled On Rush
    Rushing Longest Rush
    Rushing Red Zone Attempts
    Rushing Tackled For Safety
    Rushing Total Yards
    Rushing Touchdowns
    Total First Downs
    Two Point Conversion Attempted
    Two Point Conversion Failed
    Two Point Conversion Made
    Two Point Conversion Passing
    Two Point Conversion Receiving
    Two Point Conversion Rushing
    Penalty & Fumble Data Points: Fumbles Forced
    Fumbles Fumbles
    Fumbles Lost
    Fumbles Opponent Recovery
    Fumbles Opponent Touchdowns From Recovery
    Fumbles Out Of Bounds
    Fumbles Own Recovery
    Fumbles Own Touchdowns From Recovery
    Fumbles Yards From Opponent Recovery
    Fumbles Yards From Own Recovery
    Penalties First Downs
    Penalties Total Penalties
    Penalties Yards
    Special Teams Data Points: Blocked Field Goal Returns 10+ Yards
    Blocked Field Goal Returns 20+ Yards
    Blocked Field Goal Returns 30+ Yards
    Blocked Field Goal Returns 40+ Yards
    Blocked Field Goal Returns 50+ Yards
    Blocked Field Goal Returns Average Return
    Blocked Field Goal Returns Longest Ret.
    Blocked Field Goal Returns Returns
    Blocked Field Goal Returns Total Yards
    Blocked Field Goal Returns Touchdowns
    Blocked Punt Returns 10+ Yards
    Blocked Punt Returns 20+ Yards
    Blocked Punt Returns 30+ Yards
    Blocked Punt Returns 40+ Yards
    Blocked Punt Returns 50+ Yards
    Blocked Punt Returns Average Return
    Blocked Punt Returns Longest Return
    Blocked Punt Returns Returns
    Blocked Punt Returns Total Yards
    Blocked Punt Returns Touchdowns
    Extra Points Attempted
    Extra Points Blocked
    Extra Points Made
    Extra Points Percent Made
    Field Goal Returns 10+ Yards
    Field Goal Returns 20+ Yards
    Field Goal Returns 30+ Yards
    Field Goal Returns 40+ Yards
    Field Goal Returns 50+ Yards
    Field Goal Returns Average Return
    Field Goal Returns Longest Return
    Field Goal Returns Returns
    Field Goal Returns Total Yards
    Field Goal Returns Touchdowns
    Field Goals Attempted
    Field Goals Attempted, 1-19 Yards
    Field Goals Attempted, 20-29 Yards
    Field Goals Attempted, 30-39 Yards
    Field Goals Attempted, 40-49 Yards
    Field Goals Attempted, 50+ Yards
    Field Goals Blocked
    Field Goals Longest Made
    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 Percent Made
    Kickoff Returns 10+ Yards
    Kickoff Returns 20+ Yards
    Kickoff Returns 30+ Yards
    Kickoff Returns 40+ Yards
    Kickoff Returns 50+ Yards
    Kickoff Returns Average Return
    Kickoff Returns Fair Catches
    Kickoff Returns Longest Kick Return
    Kickoff Returns Returns
    Kickoff Returns Touchdowns
    Kickoff Returns Yards
    Kickoffs Average Gross Yards
    Kickoffs Average Net Yards
    Kickoffs Average Return Yards
    Kickoffs End Zone Kicks
    Kickoffs Gross Yards
    Kickoffs Inside Opponents 20 Yard Line
    Kickoffs Kicks
    Kickoffs Longest Kick
    Kickoffs Net Yards
    Kickoffs Percentage Inside Opponents 20 Yard Line
    Kickoffs Percentage Touchbacks
    Kickoffs Returned
    Kickoffs Total Return Yards
    Kickoffs Touchbacks
    Punt Returns 10+ Yards
    Punt Returns 20+ Yards
    Punt Returns 30+ Yards
    Punt Returns 40+ Yards
    Punt Returns 50+ Yards
    Punt Returns Average Return
    Punt Returns Fair Catches
    Punt Returns Longest Return
    Punt Returns Returns
    Punt Returns Touchdowns
    Punt Returns Yards
    Punting Average Gross Yards
    Punting Average Net Yards
    Punting Average Return Yards
    Punting Blocked
    Punting Gross Yards
    Punting Inside Opp 20 Yard Line
    Punting Longest Punt
    Punting Net Yards
    Punting Percent Inside Opp 20 Yard Line
    Punting Percent Touchbacks
    Punting Punts
    Punting Return Yards
    Punting Returned
    Punting Touchbacks
    Team Information Data Points: Id Market Name
    > To generate Game Statistics 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/ncaafb-t1/2015/REG/12/TOL/BGN/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", "/ncaafb-t1/2015/REG/12/TOL/BGN/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/ncaafb-t1/2015/REG/12/TOL/BGN/statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. To access the Game Statistics, replace the parameters in the following URL: https://api.sportradar.us/ncaafb-`{access_level}{version}`/`{season_year}`/`{ncaafb_season}`/`{ncaafb_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). | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `ncaafb_season_week` | Number of weeks into the season in 2 digit format (WW). | | `away_team` | Abbreviated team name in 2 or 3 letter format. | | `home_team` | Abbreviated team name in 2 or 3 letter format. | | `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/ncaafb-`{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: Styled XML or Raw JSON
    Game Info Data Points: Attendance
    Away Team Id
    Home Team Id
    Id
    Scheduled Kickoff
    Total Points Scored By Team
    Defense Data Points: Touchdowns From Interceptions Yards From Interceptions Safeties
    Offense Data Points: 3rd Down Conversion Attempts
    3rd Down Conversion Converted
    3rd Down Conversion Percentage
    3rd Down Conversion Via Pass
    3rd Down Conversion Via Penalty
    3rd Down Conversion Via Rush
    4th Down Conversion Attempts
    4th Down Conversion Converted
    4th Down Conversion Percentage
    4th Down Conversion Via Pass
    4th Down Conversion Via Penalty
    4th Down Conversion Via Rush
    Average Yards Per Play
    Goal Efficiency Attempts
    Goal Efficiency Percentage
    Goal Efficiency Touchdowns
    Passing Attempts
    Passing Avg. Yards Per Pass Attempt
    Passing Completions
    Passing First Downs
    Passing Gross Yards
    Passing Interceptions
    Passing Net Yards
    Passing Sacked
    Passing Sacked Yards Lost
    Passing Total Yards
    Passing Touchdowns
    Receiving First Downs
    Red Zone Efficiency Attempts
    Red Zone Efficiency Conversions
    Red Zone Efficiency Percentage
    Rushing Attempts
    Rushing Average Rush
    Rushing First Downs
    Rushing Red Zone Attempts
    Rushing Total Yards
    Rushing Touchdowns
    Time Of Possession
    Total First Downs
    Total Net Yards
    Total Offensive Plays
    Two Point Conversion Attempted
    Two Point Conversion Made
    Two Point Conversion Passing
    Two Point Conversion Receiving
    Two Point Conversion Rushing
    Penalty & Fumble Data Points: Fumbles
    Fumbles Lost
    Own Touchdowns From Recovery
    Total Penalties
    Yards
    Special Teams Data Points: Extra Points Attempted
    Extra Points Attempted By Kicking
    Extra Points Attempted By Two Point Conversion
    Extra Points Blocked
    Extra Points Made
    Extra Points Made By Kicking
    Extra Points Made By Two Point Conversion
    Extra Points Percent Made
    Field Goal Returns Touchdowns
    Field Goals Attempted
    Field Goals Blocked
    Field Goals Made
    Kickoff Returns Returns
    Kickoff Returns Touchdowns
    Kickoff Returns Yards
    Kickoffs End Zone Kicks
    Kickoffs Kicks
    Kickoffs Touchbacks
    Punt Returns Returns
    Punt Returns Touchdowns
    Punt Returns Yards
    Punting Average Gross Yards
    Punting Average Net Yards
    Punting Blocked
    Punting Punts
    Total Return Yardage
    Team Info Data Points: Id Market Name
    > To generate 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/ncaafb-t1/2015/REG/12/TOL/BGN/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", "/ncaafb-t1/2015/REG/12/TOL/BGN/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/ncaafb-t1/2015/REG/12/TOL/BGN/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/ncaafb-`{access_level}{version}`/`{season_year}`/`{ncaafb_season}`/`{ncaafb_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). | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `ncaafb_season_week` | Number of weeks into the season in 2 digit format (WW). | | `away_team` | Abbreviated team name in 2 or 3 letter format. | | `home_team` | Abbreviated team name in 2 or 3 letter format. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Game Summary, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{access_level}{version}`/schema/summary-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Play-By-Play Complete play-by-play narrative including statistics earned on each play.
    Update Frequency: Real-Time
    Content Type: XML or JSON
    Game Info Data Points: Attendance
    Away Team Id
    Clock Time
    Home Team Id
    Id
    Quarter
    Remaining Challenges
    Remaining Timeouts
    Scheduled Kickoff
    Status
    Total Points Scored By Team
    Play-By-Play Data Points: Drive Clock
    Drive Team
    Event Clock
    Event Outcome
    Event Sequence
    Event Summary
    Event Type
    Event Winner
    Game Quarter
    Play Clock
    Play Id
    Play Official
    Play Overturned
    Play Sequence
    Play Side
    Play Summary
    Play Type
    Play Yard Line
    Play Yards To First Down
    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
    Team Info Data Points: Id Market Name
    > 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/ncaafb-t1/2015/REG/12/TOL/BGN/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", "/ncaafb-t1/2015/REG/12/TOL/BGN/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/ncaafb-t1/2015/REG/12/TOL/BGN/pbp.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Play-By-Play for a game. https://api.sportradar.us/ncaafb-`{access_level}{version}`/`{season_year}`/`{ncaafb_season}`/`{ncaafb_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). | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `ncaafb_season_week` | Number of weeks into the season in 2 digit format (WW). | | `away_team` | Abbreviated team name in 2 or 3 letter format. | | `home_team` | Abbreviated team name in 2 or 3 letter format. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Play-By-Play, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{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: Real-Time
    Content Type: XML or JSON
    Game Info Data Points: Clock Time Id Quarter
    Play-By-Play Data Points: Ending Situation Down
    Ending Situation Side
    Ending Situation Team
    Ending Situation Yard Line
    Ending Situation Yards To First Down
    Play Clock
    Play Defensive Action
    Play Defensive Formation
    Play Direction
    Play Distance
    Play Down
    Play Formation
    Play Id
    Play Points Scored
    Play Score Type
    Play Scoring Team
    Play Summary
    Play Type
    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
    Defense Data Points: Interceptions
    Touchdowns From Interceptions
    Yards From Interceptions
    Total Sacks
    Yards From Sacks
    Safeties
    Assisted Tackles
    Tackles For A Loss
    Total Tackles
    Offense Data Points: Passing Attempts
    Passing Completions
    Passing First Downs
    Passing Interceptions
    Passing Red Zone Attempts
    Passing Sacked
    Passing Sacked Yards Lost
    Passing Tackled For Safety
    Passing Total Yards
    Receiving Fumbled On Reception
    Receiving Receptions
    Receiving Red Zone Targets
    Receiving Target
    Receiving Total Yards
    Receiving Touchdowns
    Receiving Yards After Completion
    Rushing Attempts
    Rushing First Downs
    Rushing Fumbled On Rush
    Rushing Tackled For A Safety
    Rushing Total Yards
    Rushing Touchdowns
    Two Point Conversion Attempted
    Two Point Conversion Made
    Two Point Conversion Passing
    Two Point Conversion Receiving
    Two Point Conversion Rushing
    Penalty & Fumble Data Points: Fumble Returns Opponent Recovery
    Fumble Returns Own Recovery
    Fumble Returns
    Fumble Returns Touchdowns
    Fumble Returns Yards
    Fumbles
    Fumbles Lost
    Fumbles Out Of Bounds
    Penalties Abbreviation
    Penalties First Downs
    Penalties Yards
    Special Teams Data Points: Blocked Field Goal Returns
    Blocked Field Goal Returns Total Yards
    Blocked Field Goal Returns Touchdowns
    Blocked Punt Returns
    Blocked Punt Returns Total Yards
    Blocked Punt Returns Touchdowns
    Extra Points Attempted
    Extra Points Blocked
    Extra Points Made
    Extra Points Percent Made
    Field Goal Returns
    Field Goal Returns Total Yards
    Field Goal Returns Touchdowns
    Field Goals Attempted
    Field Goals Blocked
    Field Goals Made
    Kickoff Returns Fair Catches
    Kickoff Returns
    Kickoff Returns Touchdowns
    Kickoff Returns Yards
    Kickoffs End Zone Kicks
    Kickoffs Gross Yards
    Kickoffs Inside Opponents 20 Yard Line
    Kickoffs
    Kickoffs Net Yards
    Kickoffs Returned
    Kickoffs Touchbacks
    Punt Returns Fair Catches
    Punt Returns
    Punt Returns Touchdowns
    Punt Returns Yards
    Punting Blocked
    Punting Gross Yards
    Punting Inside Opp 20 Yard Line
    Punting
    Punting Returned
    Punting Touchbacks
    Player Info Data Points: Full Name
    Id
    Jersey Number Position
    Team Data Points: Id Market Name
    > To generate the Play Summary for the Play ID below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/ncaafb-t1/2015/REG/12/TOL/BGN/plays/2508502b-41b9-427b-b253-9bd8951299f5.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", "/ncaafb-t1/2015/REG/12/TOL/BGN/plays/2508502b-41b9-427b-b253-9bd8951299f5.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/ncaafb-t1/2015/REG/12/TOL/BGN/plays/2508502b-41b9-427b-b253-9bd8951299f5.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Play Summary. https://api.sportradar.us/ncaafb-`{access_level}{version}`/`{season_year}`/`{ncaafb_season}`/`{ncaafb_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). | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `ncaafb_season_week` | Number of weeks into the season in 2 digit format (WW). | | `away_team` | Abbreviated team name in 2 or 3 letter format. | | `home_team` | Abbreviated team name in 2 or 3 letter format. | | `play_id` | ID of a given play. | | `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/ncaafb-`{access_level}{version}`/schema/extended-play-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Rankings Lists the current Top 25 rankings including rank, points, votes, and first place votes. The list also includes those teams not ranked, but receiving votes. We currently provide the AP Top 25, FBS Coaches Poll, Harris Poll, College Football Playoff, FCS Media Poll, and the FCS Coaches Poll.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Info Data Points: Week
    League & Season Data Points: Season Season Type
    Polls & Standings Data Points: First Place Votes
    Points
    Poll Id
    Poll Name
    Rank
    Votes
    Team Info Data Points: Id Market Name
    > To generate the Rankings for the year and week below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/ncaafb-t1/polls/AP25/2015/12/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", "/ncaafb-t1/polls/AP25/2015/12/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/ncaafb-t1/polls/AP25/2015/12/rankings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the current Rankings. https://api.sportradar.us/ncaafb-`{access_level}{version}`/polls/`{poll_name}`/`{season_year}`/`{ncaafb_season_week}`/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). | | `poll_name` | Name of the poll: AP25, EU25, H25, CFP25, FCS25, or FCSC25. | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season_week` | Number of weeks into the season in 2 digit format (WW). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Rankings, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{access_level}{version}`/schema/rankings-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Season Schedule Complete schedule information for the entire season, including game, team, and venue information.
    Update Frequency: As Necessary
    Content Type: Styled XML or JSON
    Game Info Data Points: Away Team Id
    Away Team Rotation
    Cable Broadcast Info
    Internet Broadcast Info
    Network Broadcast Info
    Satellite Broadcast Info
    Coverage
    Home Team Id
    Home Team Rotation
    Humidity
    Id
    Neutral Site
    Scheduled Kickoff
    Status
    Title
    Total Points Scored By Team
    Type
    Weather Condition
    Weather Temperature
    Week
    Wind Direction
    Wind Speed
    > To generate the Season Schedule, replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/ncaafb-t1/2013/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", "/ncaafb-t1/2013/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/ncaafb-t1/2013/REG/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. To retrieve the Season Schedule, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{access_level}{version}`/`{season_year}`/`{ncaafb_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). | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `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/ncaafb-`{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 breakouts for offense, defense, and special teams.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League & Season Data Points: Season Season Type
    Defense Data Points: Blocked Kicks
    Forced Fumbles
    Fumbles Recovered
    Fumbles Recovered For Touchdowns
    Interceptions
    Longest Interception
    Touchdowns From Interceptions
    Yards From Interceptions
    Misc. Assisted Tackles
    Misc. Combined Tackles
    Misc. Forced Fumbles
    Misc. Fumbles Recovered
    Misc. Tackles
    Passes Defended
    Quarterback Hits
    Total Sacks
    Yards From Sacks
    Safeties
    Special Teams Assisted Tackles
    Special Teams Combined Tackles
    Special Teams Forced Fumbles
    Special Teams Fumbles recovered
    Special Teams Total Tackles
    Assisted Tackles
    Combined Tackles
    Tackles For A Loss
    Total Tackles
    Offense Data Points: 3rd Down Conversion Attempts
    3rd Down Conversions
    3rd Down Conversion Percentage
    3rd Down Conversion Via Pass
    3rd Down Conversion Via Penalty
    3rd Down Conversion Via Rush
    4th Down Conversion Attempts
    4th Down Conversions
    4th Down Conversion Percentage
    4th Down Conversion Via Pass
    4th Down Conversion Via Penalty
    4th Down Conversion Via Rush
    Games Played
    Goal Efficiency Attempts
    Goal Efficiency Percentage
    Goal Efficiency Touchdowns
    Passing 10+ Yards
    Passing 20+ Yards
    Passing 30+ Yards
    Passing 40+ Yards
    Passing 50+ Yards
    Passing Attempts
    Passing Avg. Yards Per Completion
    Passing Avg. Yards Per Pass Attempt
    Passing Completion Percentage
    Passing Completions
    Passing First Downs
    Passing Interception Percentage
    Passing Interceptions
    Passing Interceptions Returned For TD
    Passing Longest Pass
    Passing Rating
    Passing Red Zone Attempts
    Passing Sacked
    Passing Sacked Yards Lost
    Passing Tackled For Safety
    Passing Total Yards
    Passing Touchdown Percentage
    Passing Touchdowns
    Receiving 10+ Yards
    Receiving 20+ Yards
    Receiving 30+ Yards
    Receiving 40+ Yards
    Receiving 50+ Yards
    Receiving Average Reception
    Receiving First Downs
    Receiving Fumbled On Reception
    Receiving Longest Reception
    Receiving Receptions
    Receiving Red Zone Targets
    Receiving Target
    Receiving Total Yards
    Receiving Touchdowns
    Receiving Yards After Completion
    Red Zone Efficiency Attempts
    Red Zone Efficiency Conversions
    Red Zone Efficiency Percentage
    Rushing 10+ Yards
    Rushing 20+ Yards
    Rushing 30+ Yards
    Rushing 40+ Yards
    Rushing 50+ Yards
    Rushing Attempts
    Rushing Average Rush
    Rushing First Down Percentage
    Rushing First Downs
    Rushing Fumbled On Rush
    Rushing Longest Rush
    Rushing Red Zone Attempts
    Rushing Tackled For A Safety
    Rushing Total Yards
    Rushing Touchdowns
    Total First Downs
    Two Point Conversion Attempted
    Two Point Conversion Failed
    Two Point Conversion Passing
    Two Point Conversion Receiving
    Two Point Conversion Rushing
    Penalty & Fumble Data Points: Fumbles Forced
    Fumbles
    Fumbles Lost
    Fumbles Opponent Recovered
    Opponent Touchdowns From Fumble Recovery
    Fumble Out Of Bounds
    Fumble Own Recovery
    Own Touchdowns From Fumble Recovery
    Yards From Opponent Recovery
    Yards From Own Recovery
    Penalties First Downs
    Total Penalties
    Penalty Yards
    Special Teams Data Points: Blocked Field Goal Returns 10+ Yards
    Blocked Field Goal Returns 20+ Yards
    Blocked Field Goal Returns 30+ Yards
    Blocked Field Goal Returns 40+ Yards
    Blocked Field Goal Returns 50+ Yards
    Blocked Field Goal Returns Average Return
    Blocked Field Goal Returns Longest Ret.
    Blocked Field Goal Returns
    Blocked Field Goal Returns Total Yards
    Blocked Field Goal Returns Touchdowns
    Blocked Punt Returns 10+ Yards
    Blocked Punt Returns 20+ Yards
    Blocked Punt Returns 30+ Yards
    Blocked Punt Returns 40+ Yards
    Blocked Punt Returns 50+ Yards
    Blocked Punt Returns Average Return
    Blocked Punt Returns Longest Return
    Blocked Punt Returns
    Blocked Punt Returns Total Yards
    Blocked Punt Returns Touchdowns
    Extra Points Attempted
    Extra Points Blocked
    Extra Points Made
    Extra Points Percent Made
    Field Goal Returns 10+ Yards
    Field Goal Returns 20+ Yards
    Field Goal Returns 30+ Yards
    Field Goal Returns 40+ Yards
    Field Goal Returns 50+ Yards
    Field Goal Returns Average Return
    Field Goal Returns Longest Return
    Field Goal Returns Returns
    Field Goal Returns Total Yards
    Field Goal Returns Touchdowns
    Field Goals Attempted
    Field Goals Attempted, 1-19 Yards
    Field Goals Attempted, 20-29 Yards
    Field Goals Attempted, 30-39 Yards
    Field Goals Attempted, 40-49 Yards
    Field Goals Attempted, 50+ Yards
    Field Goals Blocked
    Field Goals Longest Made
    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 Percent Made
    Kickoff Returns 10+ Yards
    Kickoff Returns 20+ Yards
    Kickoff Returns 30+ Yards
    Kickoff Returns 40+ Yards
    Kickoff Returns 50+ Yards
    Kickoff Returns Average Return
    Kickoff Returns Fair Catches
    Kickoff Returns Longest Kick Return
    Kickoff Returns
    Kickoff Returns Touchdowns
    Kickoff Returns Yards
    Kickoffs Average Gross Yards
    Kickoffs Average Net Yards
    Kickoffs Average Return Yards
    Kickoffs End Zone Kicks
    Kickoffs Gross Yards
    Kickoffs Inside Opponents 20 Yard Line
    Kickoffs Kicks
    Kickoffs Longest Kick
    Kickoffs Net Yards
    Kickoffs Percentage Inside Opponents 20 Yard Line
    Kickoffs Percentage Touchbacks
    Kickoffs Returned
    Kickoffs Total Return Yards
    Kickoffs Touchbacks
    Punt Returns 10+ Yards
    Punt Returns 20+ Yards
    Punt Returns 30+ Yards
    Punt Returns 40+ Yards
    Punt Returns 50+ Yards
    Punt Returns Average Return
    Punt Returns Fair Catches
    Punt Returns Longest Return
    Punt Returns
    Punt Returns Touchdowns
    Punt Returns Yards
    Punting Average Gross Yards
    Punting Average Net Yards
    Punting Average Return Yards
    Punting Blocked
    Punting Gross Yards
    Punting Inside Opp 20 Yard Line
    Punting Longest Punt
    Punting Net Yards
    Punting Percent Inside Opp 20 Yard Line
    Punting Percent Touchbacks
    Punting Punts
    Punting Return Yards
    Punting Returned
    Punting Touchbacks
    Team Info Data Points: Id Market Name
    > To generate the Seasonal Statistics for the Season and Year below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/ncaafb-t1/teams/MIN/2014/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", "/ncaafb-t1/teams/MIN/2014/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/ncaafb-t1/teams/MIN/2014/REG/statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the current Seasonal Statistics. https://api.sportradar.us/ncaafb-`{access_level}{version}`/teams/`{team_id}`/`{season_year}`/`{ncaafb_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_id` | Team Id in 2-6 letter format (Example: BGN for Bowling Green). | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Seasonal Statistics, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{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 other sport specific scenarios.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League & Season Data Points: Conference Id
    Conference Name
    Division Id
    Division Name
    Sub Division Id
    Sub Division Name
    Polls & Standings Data Points: Away Losses
    Away Winning Perc.
    Away Wins
    Decided By 7 Points Or Fewer, Losses
    Decided By 7 Points Or Fewer, Wins
    Grass Losses
    Grass Winning Perc
    Grass Wins
    Home Losses
    Home Winning Perc
    Home Wins
    In-Conference Losses
    In-Conference Winning Perc
    In-Conference Wins
    In-Division Losses
    In-Division Winning Perc
    In-Division Wins
    Last 5 Games, Losses
    Last 5 Games, Wins
    Non-Conference Losses
    Non-Conference Winning Perc
    Non-Conference Wins
    Overall Losses
    Overall Winning Perc
    Overall Wins
    Overtime Losses
    Overtime Winning Perc
    Overtime Wins
    Points Against
    Points For
    Points Net
    Recent Streak
    Streak Type
    Touchdowns Against
    Touchdowns For
    Turf Losses
    Turf Winning Perc
    Turf Wins
    When Leading At Half, Losses
    When Leading At Half, Wins
    Team Info Data Points: Id Market Name
    > To generate the Standings for the Season below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/ncaafb-t1/teams/FBS/2014/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", "/ncaafb-t1/teams/FBS/2014/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/ncaafb-t1/teams/FBS/2014/REG/standings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the current Standings. https://api.sportradar.us/ncaafb-`{access_level}{version}`/teams/`{division}`/`{season_year}`/`{ncaafb_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). | | `division` | FBS, FCS, D2, D3, NAIA, or USCAA. | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Standings, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{access_level}{version}`/schema/standings-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Team Hierarchy List off all teams in the league including conference, division, and team identification information.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League & Season Data Points: Conference Id
    Conference Name
    Division Id
    Division Name
    Sub Division Id
    Sub Division Name
    > To generate the Team Hierarchy for the Team below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/ncaafb-t1/teams/FBS/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", "/ncaafb-t1/teams/FBS/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/ncaafb-t1/teams/FBS/hierarchy.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Team Hierarchy. https://api.sportradar.us/ncaafb-`{access_level}{version}`/teams/`{division}`/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). | | `division` | FBS, FCS, D2, D3, NAIA, or USCAA. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Hierarchy, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{access_level}{version}`/schema/hierarchy-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Team Roster Player information for a team, including height/weight, jersey number, and position.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Player Info Data Points: Abbreviated Name
    Birth Place
    Class
    Date Of Birth
    First Name
    Full Name
    Height
    Id
    Jersey Number
    Last Name
    Position
    Status
    Weight
    Coach Info Data Points: Abbreviated Name
    First Name
    Full Name
    Id
    Last Name
    Position
    Salary
    Status
    Team Data Points: Id Market Name
    > To generate the Team Roster for the Team below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/ncaafb-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", "/ncaafb-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/ncaafb-t1/teams/MIN/roster.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves Team Roster. https://api.sportradar.us/ncaafb-`{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 2 or 3 letter team name. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Roster, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{access_level}{version}`/schema/roster.xsd?api_key=`{your_api_key}` Return to API map ## Weekly Division Leaders Provides the division leaders, and their corresponding stats, for the categories of passing, rushing, and receiving.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Info Data Points: Week
    Offense Data Points: Passing 10+ Yards
    Passing 20+ Yards
    Passing 30+ Yards
    Passing 40+ Yards
    Passing 50+ Yards
    Passing Attempts
    Passing Avg. Yards Per Completion
    Passing Avg. Yards Per Pass Attempt
    Passing Completion Percentage
    Passing Completions
    Passing First Downs
    Passing Interception Percentage
    Passing Interceptions
    Passing Interceptions Returned For TD
    Passing Longest Pass
    Passing Rating
    Passing Red Zone Attempts
    Passing Sacked
    Passing Sacked Yards Lost
    Passing Tackled For Safety
    Passing Total Yards
    Passing Touchdown Percentage
    Passing Touchdowns
    Receiving 10+ Yards
    Receiving 20+ Yards
    Receiving 30+ Yards
    Receiving 40+ Yards
    Receiving 50+ Yards
    Receiving Average Reception
    Receiving First Downs
    Receiving Fumbled On Reception
    Receiving Longest Reception
    Receiving Receptions
    Receiving Red Zone Targets
    Receiving Target
    Receiving Total Yards
    Receiving Touchdowns
    Receiving Yards After Completion
    Rushing 10+ Yards
    Rushing 20+ Yards
    Rushing 30+ Yards
    Rushing 40+ Yards
    Rushing 50+ Yards
    Rushing Attempts
    Rushing Average Rush
    Rushing First Down Percentage
    Rushing First Downs
    Rushing Fumbled On Rush
    Rushing Longest Rush
    Rushing Red Zone Attempts
    Rushing Tackled For A Safety
    Rushing Total Yards
    Rushing Touchdowns
    Player Info Data Points: Full Name
    Id
    Jersey Number Position
    Team Info Data Points: Id Market Name
    > To generate the Weekly Division Leaders for the Season, Year, and Week below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/ncaafb-t1/2014/REG/14/FBS/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", "/ncaafb-t1/2014/REG/14/FBS/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/ncaafb-t1/2014/REG/14/FBS/leaders.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Weakly Division Leaders. https://api.sportradar.us/ncaafb-`{access_level}{version}`/`{season_year}`/`{ncaafb_season}`/`{ncaa_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). | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `ncaafb_season_week` | Number of weeks into the season in 2 digit format (WW). | | `division` | FBS or FCS. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Seasonal Statistics, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{access_level}{version}`/schema/statistics-v1.0.xsd?api_key=`{your_api_key}` Return to API map ## Weekly Schedule Complete schedule information for the specific week of the NFL season, including game, team, and venue information. Pre-Season (PRE) valid weeks 1-4, Regular Season (REG) weeks 1-17, Post-Season (PST) weeks 1-4.
    Update Frequency: As Necessary
    Content Type: Raw XML or JSON
    Game Information Data Points: Away Team Id
    Away Team Rotation
    Cable Broadcast Info
    Internet Broadcast Info
    Network Broadcast Info
    Satellite Broadcast Info
    Coverage
    Home Team Id
    Home Team Rotation
    Humidity
    Id
    Neutral Site
    Scheduled Kickoff
    Status
    Title
    Total Points Scored By Team
    Type
    Weather Condition
    Weather Temperature
    Wind Direction
    Wind Speed
    Venue Data Points: Address
    Capacity
    City
    Country
    Id
    Name
    State
    Surface
    Type
    Zip
    > To generate the Weekly Schedule for the Year, Season, and Week below replace {your_api_key} with your API key: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/ncaafb-t1/2013/REG/12/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", "/ncaafb-t1/2013/REG/12/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/ncaafb-t1/2013/REG/12/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. To access the Weekly Schedule, replace the parameters in the following URL: https://api.sportradar.us/ncaafb-`{access_level}{version}`/`{season_year}`/`{ncaafb_season}`/`{ncaafb_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). | | `season_year` | Year in 4 digit format (YYYY). | | `ncaafb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST) - Note: PST used for 2012. | | `ncaafb_season_week` | Number of weeks into the season in 2 digit format (WW). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Schedule, replace the parameters in the following URL. https://api.sportradar.us/ncaafb-`{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 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.
    • postponed – The game has been postponed and will be re-played on a later date.
    • cancelled – The game has been cancelled and will not be re-played.

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

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

    • regular – This is a regular season game.
    • bowl – This is a bowl game (FBS postseason game).
    • playoff – This is a playoff game (FCS playoff game).

    Q: What are the valid player class values and their definitions?

    A: Here are the valid player class values and their descriptions:

    • FR – Freshman
    • SO – Sophomore
    • JR – Junior
    • SR – Senior
    • GR – Graduate Student

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

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

    • ACT – Active
    • EXE – Exempt
    • NWT – Not with Team
    • PRA – Practice Squad
    • SUS – Suspended

    Q: What are the event types we track?

    A: The valid event types are:

    • cointoss
    • teamtimeout
    • injurytimeout
    • 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 possible values for the team and game coverage levels?

    A: The valid coverage levels are:

    • full
    • extended_boxscore

    Q: Are seasonal statistics available for all teams?

    A: Full seasonal statistics are only available for teams with a coverage level of Full. The team coverage levels can be found in the team hierarchy feed.

    Q: What are the valid season types?

    A: The only valid season for NCAAFB is REG. All FBS bowl and FCS playoff games will appear in the specific week number the game is taking place in. As these games get announced, an additional week will be added to the schedule that will include all scheduled games.

    Please note: For the 2012 season, we did use the PST season type for the bowl season.

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