Syntax

https://api.sportradar.com/ncaafb/{access_level}/stream/{language_code}/statistics/subscribe

Note: We recommend using Push exclusively for full coverage games

Parameters

Parameter	Description
`access_level`	Defines the access level of your API key `production`, `trial`
`language_code`	2-letter code for supported languages `en` (English)

Optional Query String Parameters

By default, a Push feed will provide all data available for all in progress games. If needed, you can filter the data returned by including query strings.

Each query string parameter can be added with a preceding ampersand (&).

Parameter	Description
`match`	Match id Example: `match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d`
`team`	Team id Example: `team=sd:team:19775492-f1eb-4bc5-9e15-078ebd689c0f`
`status`	Game status `inprogress`, `created` Example: `status=inprogress`

Code Samples

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/ncaafb/trial/stream/en/statistics/subscribe")

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)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body

import requests
import json

headers = {
    'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get(
    "https://api.sportradar.com/ncaafb/trial/stream/en/statistics/subscribe",
    headers=headers,
    allow_redirects=False
)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True, headers=headers)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))

curl -L -X GET 'https://api.sportradar.com/ncaafb/trial/stream/en/statistics/subscribe' \
  -H 'x-api-key: {your_api_key}'

Samples with Query String Params

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/ncaafb/trial/stream/en/statistics/subscribe?&status=inprogress&match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d")

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)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body

import requests
import json

headers = {
    'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get("https://api.sportradar.com/ncaafb/trial/stream/en/statistics/subscribe",
    params = {'status': 'inprogress', 'match': 'sd:match:673b459c-7506-4c11-9273-1b9502537f1d'},
    allow_redirects=False)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))

curl -L -X GET 'api.sportradar.com/ncaafb/trial/stream/en/statistics/subscribe?&status=inprogress&match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d'
  -H 'x-api-key: {your_api_key}'

Sample Data

The above commands return json like this.

Simulations

Check out our Simulations to replay actual games at any time, on your own schedule. Push simulations are available as well.

Data Points

Boxscore

Attribute	Parent Element	Type	Description
`attendance`	`payload`	Integer	Attendance of a game ex. `73242`
`remaining_challenges`	`away`	Integer	Away team challenges remaining
`remaining_timeouts`	`away`	Integer	Away team timeouts remaining
`used_timeouts`	`away`	Integer	Away team timeouts used
`used_challenges`	`away`	Integer	Away team challenges used
`clock`	`payload`	String	Clock value of the game ex. `12:37`
`remaining_challenges`	`home`	Integer	Home team challenges remaining
`remaining_timeouts`	`home`	Integer	Home team timeouts remaining
`used_timeouts`	`home`	Integer	Home team timeouts used
`used_challenges`	`home`	Integer	Home team challenges used
`points`	`home`	Integer	Home team points in the game
`points`	`away`	Integer	Away team points in the game
`quarter`	`payload`	Integer	Quarter number of the game

Game

Attribute	Parent Element	Type	Description
`alias`	`away`	String	Away team alias ex. `TCU` (Texas Christian University)
`id`	`away`	GUID	Unique ID of the away team ex. `a09e634d-39a8-4aa8-81a4-7337580a31f4`
`market`	`away`	String	Away team market name ex. `TCU`
`name`	`away`	String	Away team name ex. `Horned Frogs`
`conference_game`	`payload`	Boolean	Signifies an in-Conference matchup ex. (SEC vs. SEC)
`coverage`	`payload`	String	Coverage level of a game `full`, `extended_boxscore`
`duration`	`payload`	String	Duration of a game ex. `2:52`
`entry_mode`	`payload`	String	Type of data entry for the game `LDE` (Live Data Entry)
`expected_latency`	`game`	Integer	The time in seconds a game is expected to be behind real-time play on the field, with possible values of 2, 10, 25, and 50. For example, a value of `10` indicates a game is 10 or more seconds behind real-time, but less than 25. Latency values are made available one day before gameday, though they are subject to change on gameday itself. `2`, `10`, `25`, `50`
`alias`	`home`	String	Home team alias ex. `UGA` (University of Georgia)
`id`	`home`	GUID	Unique ID of the home team ex. `2eef738d-c637-4b12-b8df-4b79efcce71e`
`market`	`home`	String	Home team market name ex. `Georgia`
`name`	`home`	String	Home team name ex. `Bulldogs`
`id`	`payload`	GUID	Unique ID of a game ex. `c9686716-f48a-4667-996d-97639429d8c3`
`neutral_site`	`payload`	Boolean	Signifies a game is held at a neutral site
`scheduled`	`payload`	Date/Time	Scheduled date and time of a game ex. `2022-09-25T20:10:00+00:00`
`sr_id`	`payload`	String	Unique Sportradar ID of a game ex. `sr:match:38354639`
`status`	`payload`	String	Game status `scheduled`, `created`, `inprogress`, `halftime`, `complete`, `closed`, `cancelled`, `postponed`, `delayed`, `suspended`, `flex-schedule`, `time-tbd` See our NCAAFB FAQ for game status descriptions
`title`	`payload`	String	Game title ex. `CFP National Championship`
`wx_condition`	`payload`	String	Weather condition for a game ex. `Partly cloudy`, `Clear`, `Light Rain, Mist` Click here for more info on weather condition values
`wx_humidity`	`payload`	Byte	Humidity conditions for a game ex. `44`
`wx_temp`	`payload`	Byte	Temperature of a game in Fahrenheit ex. `57`
`wx_wind_direction`	`payload`	String	Wind direction for a game ex. `N`
`wx_wind_speed`	`payload`	Byte	Wind speed for a game in MPH

Game Statistics - Conversions (Player)

Attribute	Parent Element	Type	Description
`attempts`	`extra_points` - `conversions` - `player`	Integer	Number of two-point conversion attempts
`category`	`extra_points` - `conversions` - `player`	String	Category of conversion `pass`, `receive`, `rush`, `defense`
`successes`	`extra_points` - `conversions` - `player`	Integer	Number of successful two-point conversions

Game Statistics - Defense (Player)

Attribute	Parent Element	Type	Description
`assists`	`defense` - `player`	Integer	Number of defensive assisted tackles Does not include misc. or special teams tackles
`combined`	`defense` - `player`	Integer	Number of combined (`assists` + `tackles`) defensive tackles Does not include misc. or special teams tackles
`forced_fumbles`	`defense` - `player`	Integer	Number of forced fumbles
`fumble_recoveries`	`defense` - `player`	Integer	Number of fumble recoveries
`interceptions`	`defense` - `player`	Integer	Number of interceptions
`misc_assists`	`defense` - `player`	Integer	Number of miscellaneous assisted tackles. Ex: An assisted tackle by an offensive player on a defensive interception or fumble return
`misc_forced_fumbles`	`defense` - `player`	Integer	Number of miscellaneous forced fumbles. Ex: A forced fumble by an offensive player on a defensive interception or fumble return
`misc_fumble_recoveries`	`defense` - `player`	Integer	Number of miscellaneous fumble recoveries. Ex: A fumble recovery by an offensive player on a defensive interception or fumble return
`misc_tackles`	`defense` - `player`	Integer	Number of miscellaneous tackles. Ex: A solo tackle by an offensive player on a defensive interception or fumble return
`missed_tackles`	`defense` - `player`	Integer	Number of missed tackles
`passes_defended`	`defense` - `player`	Integer	Number of passes defended
`qb_hits`	`defense` - `player`	Integer	Number of hits on the quarterback
`sack_yards`	`defense` - `player`	Decimal	Number of sack yards
`sacks`	`defense` - `player`	Decimal	Number of sacks
`safeties`	`defense` - `player`	Integer	Number of safeties
`sp_assists`	`defense` - `player`	Integer	Number of special teams assisted tackles
`sp_blocks`	`defense` - `player`	Integer	Number of blocked kicks/punts
`sp_forced_fumbles`	`defense` - `player`	Integer	Number of special teams forced fumbles
`sp_fumble_recoveries`	`defense` - `player`	Integer	Number of special teams fumble recoveries
`sp_tackles`	`defense` - `player`	Integer	Number of special teams tackles
`tackles`	`defense` - `player`	Integer	Number of defensive tackles Does not include misc. or special teams tackles
`tloss`	`defense` - `player`	Decimal	Number of tackles for a loss
`tloss_yards`	`defense` - `player`	Decimal	Number of tackles for a loss yardage

Game Statistics - Extra Points (Player)

Attribute	Parent Element	Type	Description
`attempts`	`extra_points` - `kicks` - `player`	Integer	Number of attempted extra points
`blocked`	`extra_points` - `kicks` - `player`	Integer	Number of blocked extra points
`made`	`extra_points` - `kicks` - `player`	Integer	Number of made extra points
`missed`	`extra_points` - `kicks` - `player`	Integer	Number of missed extra points
`pct`	`extra_points` - `kicks` - `player`	Decimal	Extra point percentage ex. `75.0`

Game Statistics - Field Goals (Player)

Attribute	Parent Element	Type	Description
`attempts`	`field_goals` - `player`	Integer	Number of attempted field goals
`attempts_19`	`field_goals` - `player`	Integer	Number of attempted field goals between 1-19 yards
`attempts_29`	`field_goals` - `player`	Integer	Number of attempted field goals between 20-29 yards
`attempts_39`	`field_goals` - `player`	Integer	Number of attempted field goals between 30-39 yards
`attempts_49`	`field_goals` - `player`	Integer	Number of attempted field goals between 40-49 yards
`attempts_50`	`field_goals` - `player`	Integer	Number of attempted field goals of 50 yards or more
`avg_yards`	`field_goals` - `player`	Decimal	Average number of yards on attempted field goals ex. `38.5`
`blocked`	`field_goals` - `player`	Integer	Number of blocked field goals
`longest`	`field_goals` - `player`	Integer	Number of yards of longest made field goal
`made`	`field_goals` - `player`	Integer	Number of made field goals
`made_19`	`field_goals` - `player`	Integer	Number of successful field goals between 1-19 yards
`made_29`	`field_goals` - `player`	Integer	Number of successful field goals between 20-29 yards
`made_39`	`field_goals` - `player`	Integer	Number of successful field goals between 30-39 yards
`made_49`	`field_goals` - `player`	Integer	Number of successful field goals between 40-49 yards
`made_50`	`field_goals` - `player`	Integer	Number of successful field goals of 50 yards or more
`missed`	`field_goals` - `player`	Integer	Number of missed field goals
`pct`	`field_goals` - `player`	Decimal	Field goal percentage ex. `75.0`
`yards`	`field_goals` - `player`	Integer	Number of total yards on successful field goals

Game Statistics - Fumbles (Player)

Attribute	Parent Element	Type	Description
`ez_rec_tds`	`fumbles` - `player`	Integer	Number of end zone fumble recovery touchdowns
`forced_fumbles`	`fumbles` - `player`	Integer	Number of forced fumbles
`fumbles`	`fumbles` - `player`	Integer	Number of fumbles
`lost_fumbles`	`fumbles` - `player`	Integer	Number of lost fumbles
`opp_rec`	`fumbles` - `player`	Integer	Number of opponent fumble recoveries
`opp_rec_tds`	`fumbles` - `player`	Integer	Number of opponent fumble recovery touchdowns
`opp_rec_yards`	`fumbles` - `player`	Integer	Number of opponent fumble recovery yards
`out_of_bounds`	`fumbles` - `player`	Integer	Number of opponent fumbles out of bounds
`own_rec`	`fumbles` - `player`	Integer	Number of own fumble recoveries
`own_rec_tds`	`fumbles` - `player`	Integer	Number of own fumble recovery touchdowns
`own_rec_yards`	`fumbles` - `player`	Integer	Number of own fumble recovery yards

Game Statistics - Interception Returns (Player)

Attribute	Parent Element	Type	Description
`avg_yards`	`int_returns` - `player`	Decimal	Average number of yards on interception returns ex. `38.5`
`longest`	`int_returns` - `player`	Integer	Number of yards of longest interception return
`returns`	`int_returns` - `player`	Integer	Number of interception returns
`touchdowns`	`int_return` - `player`	Integer	Number of interception return touchdowns
`yards`	`int_returns` - `player`	Integer	Number of total interception return yards

Game Statistics - Kick Returns (Player)

Attribute	Parent Element	Type	Description
`avg_yards`	`kick_returns` - `player`	Decimal	Average number of yards on kick returns ex. `19.5`
`faircatches`	`kick_returns` - `player`	Integer	Number of fair catches on kick returns
`longest`	`kick_returns` - `player`	Integer	Number of yards of longest kick return
`returns`	`kick_returns` - `player`	Integer	Number of kick returns
`touchdowns`	`kick_returns` - `player`	Integer	Number of kick return touchdowns
`yards`	`kick_returns` - `player`	Integer	Number of total kick return yards

Game Statistics - Kickoffs (Player)

Attribute	Parent Element	Type	Description
`endzone`	`kickoffs` - `player`	Integer	Number of kickoffs into the endzone
`inside_20`	`kickoffs` - `player`	Integer	Number of kickoffs inside the 20 yardline
`kickoffs`	`kickoffs` - `player`	Integer	Number of kickoffs
`out_of_bounds`	`kickoffs` - `player`	Integer	Number of kickoffs out of bounds
`return_yards`	`kickoffs` - `player`	Integer	Number of total return yards on kickoffs
`total_endzone`	`kickoffs` - `player`	Integer	Number of total kickoffs into the endzone (touchbacks + endzone kicks)
`touchbacks`	`kickoffs` - `player`	Integer	Number of touchbacks
`yards`	`kickoffs` - `player`	Integer	Number of kickoff yards

Game Statistics - Passing (Player)

Attribute	Parent Element	Type	Description
`air_yards`	`passing`	Integer	Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point) *Air yards is not currently a collected statistic for NCAA Football*
`attempts`	`passing` - `player`	Integer	Number of pass attempts
`avg_yards`	`passing` - `player`	Decimal	Average yards per pass attempt ex. `7.22`
`cmp_pct`	`passing` - `player`	Decimal	Completion percentage ex. `78.049`
`completions`	`passing` - `player`	Integer	Number of pass completions
`first_downs`	`passing` - `player`	Integer	Number of first downs
`interceptions`	`passing` - `player`	Integer	Number of interceptions thrown
`int_touchdowns`	`passing` - `player`	Integer	Number of interceptions thrown returned for touchdowns
`longest`	`passing` - `player`	Integer	Number of yards of longest completed pass
`longest_touchdown`	`passing` - `player`	Integer	Number of yards of longest pass for a touchdown
`rating`	`passing` - `player`	Decimal	Passer rating ex. `94.7`
`redzone_attempts`	`passing` - `player`	Integer	Number of pass attempts in the red zone
`sack_yards`	`passing` - `player`	Integer	Number of sack yards
`sacks`	`passing` - `player`	Integer	Number of sacks
`touchdowns`	`passing` - `player`	Integer	Number of passing touchdowns
`yards`	`passing` - `player`	Integer	Number of passing yards

Game Statistics - Penalties (Player)

Attribute	Parent Element	Type	Description
`first_downs`	`penalties` - `player`	Integer	Number of penalties resulting in a first down
`penalties`	`penalties` - `player`	Integer	Number of penalties
`yards`	`penalties` - `player`	Integer	Number of penalty yardage

Game Statistics - Punt Returns (Player)

Attribute	Parent Element	Type	Description
`avg_yards`	`punt_returns` - `player`	Decimal	Average number of yards on punt returns ex. `19.5`
`faircatches`	`punt_returns` - `player`	Integer	Number of fair catches on punt returns
`longest`	`punt_returns` - `player`	Integer	Number of yards of longest punt return
`returns`	`punt_returns` - `player`	Integer	Number of punt returns
`touchdowns`	`punt_returns` - `player`	Integer	Number of punt return touchdowns
`yards`	`punt_returns` - `player`	Integer	Number of total punt return yards

Game Statistics - Punts (Player)

Attribute	Parent Element	Type	Description
`attempts`	`punts` - `player`	Integer	Number of punt attempts
`avg_net_yards`	`punts` - `player`	Decimal	Average net yards on punts ex. `28.75`
`avg_yards`	`punts` - `player`	Decimal	Average yards on punts ex. `43.75`
`blocked`	`punts` - `player`	Integer	Number of punts blocked
`inside_20`	`punts` - `player`	Integer	Number of punts inside the 20 yardline
`longest`	`punts` - `player`	Integer	Number of yards of longest punt
`net_yards`	`punts` - `player`	Integer	Number of total net punt yards
`return_yards`	`punts` - `player`	Integer	Number of total return punt yards
`return_yards`	`punts` - `player`	Integer	Number of total return yards on punts
`touchbacks`	`punts` - `player`	Integer	Number of touchbacks
`yards`	`punts` - `player`	Integer	Number of punt yards

Game Statistics - Receiving (Player)

Attribute	Parent Element	Type	Description
`air_yards`	`receiving`	Integer	Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point) *Air yards is not currently a collected statistic for NCAA Football*
`avg_yards`	`receiving` - `player`	Decimal	Average yards per reception ex. `7.22`
`first_downs`	`receiving` - `player`	Integer	Number of receiving first downs
`longest`	`receiving` - `player`	Integer	Number of yards of longest reception
`longest_touchdown`	`receiving` - `player`	Integer	Number of yards of longest receiving touchdown
`receptions`	`receiving` - `player`	Integer	Number of receptions
`redzone_targets`	`receiving` - `player`	Integer	Number of receiving red zone targets
`targets`	`receiving` - `player`	Integer	Number of receiving targets
`touchdowns`	`receiving` - `player`	Integer	Number of receiving touchdowns
`yards`	`receiving` - `player`	Integer	Number of receiving yards
`yards_after_catch`	`receiving` - `player`	Integer	Number of receiving yards after the catch Yards after catch is not currently a collected statistic for NCAA Football

Game Statistics - Rushing (Player)

Attribute	Parent Element	Type	Description
`attempts`	`rushing` - `player`	Integer	Number of rushing attempts
`avg_yards`	`rushing` - `player`	Decimal	Average yards per rush ex. `3.22`
`first_downs`	`rushing` - `player`	Integer	Number of rushing first downs
`longest`	`rushing` - `player`	Integer	Number of yards of longest rush
`longest_touchdown`	`rushing` - `player`	Integer	Number of yards of longest rushing touchdown
`redzone_attempts`	`rushing` - `player`	Integer	Number of rushing red zone attempts
`tlost`	`rushing` - `player`	Integer	Number of rushing tackles for a loss
`tlost_yards`	`rushing` - `player`	Integer	Number of rushing tackles for a loss yardage
`touchdowns`	`rushing` - `player`	Integer	Number of rushing touchdowns
`yards`	`rushing` - `player`	Integer	Number of rushing yards

Game Statistics - Conversions (Team)

Attribute	Parent Element	Type	Description
`def_conv_attempts`	`extra_points`	Integer	Number of defensive two-point conversion attempts
`def_conv_successes`	`extra_points`	Integer	Number of successful defensive two-point conversions
`pass_conv_attempts`	`extra_points`	Integer	Number of two-point conversion passing attempts
`pass_conv_successes`	`extra_points`	Integer	Number of successful passing two-point conversions
`rush_conv_attempts`	`extra_points`	Integer	Number of two-point conversion rushing attempts
`rush_conv_successes`	`extra_points`	Integer	Number of successful rushing two-point conversions

Game Statistics - Defense (Team)

Attribute	Parent Element	Type	Description
`assists`	`defense`	Integer	Number of defensive assisted tackles *Does not include misc. or special teams tackles
`combined`	`defense`	Integer	Number of combined (`assists` + `tackles`) defensive tackles *Does not include misc. or special teams tackles
`forced_fumbles`	`defense`	Integer	Number of forced fumbles
`fourth_down_stops`	`defense`	Integer	Number of fourth down stops
`fumble_recoveries`	`defense`	Integer	Number of fumble recoveries
`interceptions`	`defense`	Integer	Number of interceptions
`misc_assists`	`defense`	Integer	Number of miscellaneous assisted tackles. Ex: An assisted tackle by an offensive player on a defensive interception or fumble return
`misc_forced_fumbles`	`defense`	Integer	Number of miscellaneous forced fumbles. Ex: A forced fumble by an offensive player on a defensive interception or fumble return
`misc_fumble_recoveries`	`defense`	Integer	Number of miscellaneous fumble recoveries. Ex: A fumble recovery by an offensive player on a defensive interception or fumble return
`misc_tackles`	`defense`	Integer	Number of miscellaneous tackles. Ex: A solo tackle by an offensive player on a defensive interception or fumble return
`passes_defended`	`defense`	Integer	Number of passes defended
`qb_hits`	`defense`	Integer	Number of hits on the quarterback
`sack_yards`	`defense`	Decimal	Number of sack yards
`sacks`	`defense`	Decimal	Number of sacks
`safeties`	`defense`	Integer	Number of safeties
`sp_assists`	`defense`	Integer	Number of special teams assisted tackles
`sp_blocks`	`defense`	Integer	Number of blocked kicks/punts
`sp_forced_fumbles`	`defense`	Integer	Number of special teams forced fumbles
`sp_fumble_recoveries`	`defense`	Integer	Number of special teams fumble recoveries
`sp_tackles`	`defense`	Integer	Number of special teams tackles
`tackles`	`defense`	Integer	Number of defensive tackles *Does not include misc. or special teams tackles
`three_and_outs_forced`	`defense`	Integer	Number of three and outs forced
`tloss`	`defense`	Decimal	Number of tackles for a loss
`tloss_yards`	`defense`	Decimal	Number of tackles for a loss yardage

Game Statistics - Efficiency (Team)

Attribute	Parent Element	Type	Description
`attempts`	`team` - `efficiency` - `thirddown`	Integer	Number of third down attempts
`successes`	`team` - `efficiency` - `thirddown`	Integer	Number of third down successes
`pct`	`team` - `efficiency` - `thirddown`	Decimal	Third down conversion percentage ex. `61.538`
`attempts`	`team` - `efficiency` - `fourthdown`	Integer	Number of fourth down attempts
`successes`	`team` - `efficiency` - `fourthdown`	Integer	Number of fourth down successes
`pct`	`team` - `efficiency` - `fourthdown`	Decimal	Fourth down conversion percentage ex. `50.0`
`attempts`	`team` - `efficiency` - `goaltogo`	Integer	Number of goal-to-go attempts (eg. 1st & Goal, 2nd & Goal, etc.)
`successes`	`team` - `efficiency` - `goaltogo`	Integer	Number of goal-to-go successes (eg. 1st & Goal, 2nd & Goal, etc.)
`pct`	`team` - `efficiency` - `goaltogo`	Decimal	Goal-to-go conversion percentage (eg. 1st & Goal, 2nd & Goal, etc.) ex. `100.0`
`attempts`	`team` - `efficiency` - `redzone`	Integer	Number of red zone attempts
`successes`	`team` - `efficiency` - `redzone`	Integer	Number of red zone successes
`pct`	`team` - `efficiency` - `redzone`	Decimal	Red zone conversion percentage ex. `80.0`

Game Statistics - Extra Points (Team)

Attribute	Parent Element	Type	Description
`attempts`	`extra_points` - `kicks`	Integer	Number of attempted extra points
`blocked`	`extra_points` - `kicks`	Integer	Number of blocked extra points
`made`	`extra_points` - `kicks`	Integer	Number of made extra points
`missed`	`extra_points` - `kicks`	Integer	Number of missed extra points
`pct`	`extra_points` - `kicks`	Decimal	Extra point percentage ex. `75.0`

Game Statistics - Field Goals (Team)

Attribute	Parent Element	Type	Description
`attempts`	`field_goals`	Integer	Number of attempted field goals
`attempts_19`	`field_goals`	Integer	Number of attempted field goals between 1-19 yards
`attempts_29`	`field_goals`	Integer	Number of attempted field goals between 20-29 yards
`attempts_39`	`field_goals`	Integer	Number of attempted field goals between 30-39 yards
`attempts_49`	`field_goals`	Integer	Number of attempted field goals between 40-49 yards
`attempts_50`	`field_goals`	Integer	Number of attempted field goals of 50 yards or more
`avg_yards`	`field_goals`	Decimal	Average number of yards on attempted field goals ex. `38.5`
`blocked`	`field_goals`	Integer	Number of blocked field goals
`longest`	`field_goals`	Integer	Number of yards of longest made field goal
`made`	`field_goals` - `player`	Integer	Number of made field goals
`made_19`	`field_goals`	Integer	Number of successful field goals between 1-19 yards
`made_29`	`field_goals`	Integer	Number of successful field goals between 20-29 yards
`made_39`	`field_goals`	Integer	Number of successful field goals between 30-39 yards
`made_49`	`field_goals`	Integer	Number of successful field goals between 40-49 yards
`made_50`	`field_goals`	Integer	Number of successful field goals of 50 yards or more
`missed`	`field_goals`	Integer	Number of missed field goals
`net_attempts`	`field_goals`	Integer	Number of net field goal attempts
`pct`	`field_goals`	Decimal	Field goal percentage ex. `75.0`
`yards`	`field_goals`	Integer	Number of total yards on successful field goals

Game Statistics - First Downs (Team)

Attribute	Parent Element	Type	Description
`pass`	`first_downs`	Integer	Number of passing first downs
`penalty`	`first_downs`	Integer	Number of first downs due to penalty
`rush`	`first_downs`	Integer	Number of rushing first downs
`total`	`first_downs`	Integer	Number of total first downs

Game Statistics - Fumbles (Team)

Attribute	Parent Element	Type	Description
`ez_rec_tds`	`fumbles`	Integer	Number of end zone fumble recovery touchdowns
`forced_fumbles`	`fumbles`	Integer	Number of forced fumbles
`fumbles`	`fumbles`	Integer	Number of fumbles
`lost_fumbles`	`fumbles`	Integer	Number of lost fumbles
`opp_rec`	`fumbles`	Integer	Number of opponent fumble recoveries
`opp_rec_tds`	`fumbles`	Integer	Number of opponent fumble recovery touchdowns
`opp_rec_yards`	`fumbles`	Integer	Number of opponent fumble recovery yards
`out_of_bounds`	`fumbles`	Integer	Number of opponent fumbles out of bounds
`own_rec`	`fumbles`	Integer	Number of own fumble recoveries
`own_rec_tds`	`fumbles`	Integer	Number of own fumble recovery touchdowns
`own_rec_yards`	`fumbles`	Integer	Number of own fumble recovery yards

Game Statistics - Interception Returns (Team)

Attribute	Parent Element	Type	Description
`avg_yards`	`int_returns`	Decimal	Average number of yards on interception returns ex. `38.5`
`longest`	`int_returns`	Integer	Number of yards of longest interception return
`returns`	`int_returns`	Integer	Number of interception returns
`touchdowns`	`int_returns`	Integer	Number of interception return touchdowns
`yards`	`int_returns`	Integer	Number of total interception return yards
`interceptions`	`interceptions`	Integer	Number of interceptions
`return_yards`	`interceptions`	Integer	Number of interception return yards
`returned`	`interceptions`	Integer	Number of interceptions returned

Game Statistics - Kick Returns (Team)

Attribute	Parent Element	Type	Description
`avg_yards`	`kick_returns`	Decimal	Average number of yards on kick returns ex. `19.5`
`faircatches`	`kick_returns`	Integer	Number of fair catches on kick returns
`longest`	`kick_returns`	Integer	Number of yards of longest kick return
`returns`	`kick_returns`	Integer	Number of kick returns
`touchdowns`	`kick_returns`	Integer	Number of kick return touchdowns
`yards`	`kick_returns`	Integer	Number of total kick return yards

Game Statistics - Kickoffs (Team)

Attribute	Parent Element	Type	Description
`endzone`	`kickoffs`	Integer	Number of kickoffs into the endzone
`inside_20`	`kickoffs`	Integer	Number of kickoffs inside the 20 yardline
`kickoffs`	`kickoffs`	Integer	Number of kickoffs
`out_of_bounds`	`kickoffs`	Integer	Number of kickoffs out of bounds
`return_yards`	`kickoffs`	Integer	Number of total return yards on kickoffs
`total_endzone`	`kickoffs`	Integer	Number of total kickoffs into the endzone (touchbacks + endzone kicks)
`touchbacks`	`kickoffs`	Integer	Number of touchbacks
`yards`	`kickoffs`	Integer	Number of kickoff yards

Game Statistics - Miscellaneous Returns (Team)

Attribute	Parent Element	Type	Description
`blk_fg_touchdowns`	`misc_returns`	Integer	Number of blocked field goals returned for touchdowns
`blk_punt_touchdowns`	`misc_returns`	Integer	Number of blocked punts returned for touchdowns
`ez_rec_touchdowns`	`misc_returns`	Integer	Number of end zone recovery touchdowns
`fg_touchdowns`	`misc_returns`	Integer	Number of field goal attempts returned for touchdowns
`returns`	`misc_returns`	Integer	Number of miscellaneous returns
`touchdowns`	`misc_returns`	Integer	Number of miscellaneous returns for touchdowns
`yards`	`misc_returns`	Integer	Number of miscellaneous return yardage

Game Statistics - Passing (Team)

Attribute	Parent Element	Type	Description
`air_yards`	`passing`	Integer	Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point) *Air yards is not currently a collected statistic for NCAA Football*
`attempts`	`passing`	Integer	Number of pass attempts
`avg_yards`	`passing`	Decimal	Average yards per pass attempt ex. `7.22`
`cmp_pct`	`passing`	Decimal	Completion percentage ex. `78.049`
`completions`	`passing`	Integer	Number of pass completions
`first_downs`	`passing`	Integer	Number of first downs
`interceptions`	`passing`	Integer	Number of interceptions thrown
`int_touchdowns`	`passing`	Integer	Number of interceptions thrown returned for touchdowns
`longest`	`passing`	Integer	Number of yards of longest completed pass
`longest_touchdown`	`passing`	Integer	Number of yards of longest pass for a touchdown
`net_yards`	`passing`	Integer	Number of net yards passing
`rating`	`passing`	Decimal	Passer rating ex. `94.7`
`redzone_attempts`	`passing`	Integer	Number of pass attempts in the red zone
`sack_yards`	`passing`	Integer	Number of sack yards
`sacks`	`passing`	Integer	Number of sacks
`touchdowns`	`passing`	Integer	Number of passing touchdowns
`yards`	`passing`	Integer	Number of passing yards

Game Statistics - Penalties (Team)

Attribute	Parent Element	Type	Description
`first_downs`	`penalties`	Integer	Number of penalties resulting in a first down
`penalties`	`penalties`	Integer	Number of penalties
`yards`	`penalties`	Integer	Number of penalty yardage

Game Statistics - Punt Returns (Team)

Attribute	Parent Element	Type	Description
`avg_yards`	`punt_returns`	Decimal	Average number of yards on punt returns ex. `19.5`
`faircatches`	`punt_returns`	Integer	Number of fair catches on punt returns
`longest`	`punt_returns`	Integer	Number of yards of longest punt return
`returns`	`punt_returns`	Integer	Number of punt returns
`touchdowns`	`punt_returns`	Integer	Number of punt return touchdowns
`yards`	`punt_returns`	Integer	Number of total punt return yards

Game Statistics - Punts (Team)

Attribute	Parent Element	Type	Description
`attempts`	`punts`	Integer	Number of punt attempts
`avg_net_yards`	`punts`	Decimal	Average net yards on punts ex. `28.75`
`avg_yards`	`punts`	Decimal	Average yards on punts ex. `43.75`
`blocked`	`punts`	Integer	Number of punts blocked
`inside_20`	`punts`	Integer	Number of punts inside the 20 yardline
`longest`	`punts`	Integer	Number of yards of longest punt
`net_yards`	`punts`	Integer	Number of total net punt yards
`return_yards`	`punts`	Integer	Number of total return yards on punts
`touchbacks`	`punts`	Integer	Number of touchbacks
`yards`	`punts`	Integer	Number of punt yards

Game Statistics - Receiving (Team)

Attribute	Parent Element	Type	Description
`air_yards`	`receiving`	Integer	Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point) *Air yards is not currently a collected statistic for NCAA Football*
`avg_yards`	`receiving`	Decimal	Average yards per reception ex. `7.22`
`first_downs`	`receiving`	Integer	Number of receiving first downs
`longest`	`receiving`	Integer	Number of yards of longest reception
`longest_touchdown`	`receiving`	Integer	Number of yards of longest receiving touchdown
`receptions`	`receiving`	Integer	Number of receptions
`redzone_targets`	`receiving`	Integer	Number of receiving red zone targets
`targets`	`receiving`	Integer	Number of receiving targets
`touchdowns`	`receiving`	Integer	Number of receiving touchdowns
`yards`	`receiving`	Integer	Number of receiving yards
`yards_after_catch`	`receiving`	Integer	Number of receiving yards after the catch Yards after catch is not currently a collected statistic for NCAA Football

Game Statistics - Rushing (Team)

Attribute	Parent Element	Type	Description
`attempts`	`rushing`	Integer	Number of rushing attempts
`avg_yards`	`rushing`	Decimal	Average yards per rush ex. `3.22`
`first_downs`	`rushing`	Integer	Number of rushing first downs
`longest`	`rushing`	Integer	Number of yards of longest rush
`longest_touchdown`	`rushing`	Integer	Number of yards of longest rushing touchdown
`redzone_attempts`	`rushing`	Integer	Number of rushing red zone attempts
`tlost`	`rushing`	Integer	Number of rushing tackles for a loss
`tlost_yards`	`rushing`	Integer	Number of rushing tackles for a loss yardage
`touchdowns`	`rushing`	Integer	Number of rushing touchdowns
`yards`	`rushing`	Integer	Number of rushing yards

Game Statistics - Touchdowns (Team)

Attribute	Parent Element	Type	Description
`fumble_return`	`touchdowns`	Integer	Number of fumble return touchdowns
`int_return`	`touchdowns`	Integer	Number of interception return touchdowns
`kick_return`	`touchdowns`	Integer	Number of kick return touchdowns
`other`	`touchdowns`	Integer	Number of touchdowns outside of other categories. Common examples are blocked kicks or punts returned for scores.
`pass`	`touchdowns`	Integer	Number of passing touchdowns
`punt_return`	`touchdowns`	Integer	Number of punt return touchdowns
`rush`	`touchdowns`	Integer	Number of rushing touchdowns
`total`	`touchdowns`	Integer	Number of total touchdowns
`total_return`	`touchdowns`	Integer	Number of total return touchdowns

Game Statistics - Team Summary

Attribute	Parent Element	Type	Description
`avg_gain`	`summary`	Decimal	Average yards per play ex. `7.6`
`fumbles`	`summary`	Integer	Number of fumbles
`lost_fumbles`	`summary`	Integer	Number of fumbles lost
`penalties`	`summary`	Integer	Number of penalties
`penalty_yards`	`summary`	Integer	Number of penalty yards
`play_count`	`summary`	Integer	Number of offensive plays
`possession_time`	`summary`	Integer	Time of possession ex. `36:38`
`return_yards`	`summary`	Integer	Number of return yards
`rush_plays`	`summary`	Integer	Number of rushing plays
`safeties`	`summary`	Integer	Number of safeties
`total_yards`	`summary`	Integer	Number of total yards
`turnovers`	`summary`	Integer	Number of turnovers

League

Attribute	Parent Element	Type	Description
`id`	`summary` - `season`	GUID	Unique season ID ex. `ff53e5e4-10ef-4842-a0b7-b489956fa07e`
`name`	`summary` - `season`	String	Name of the season `REG`
`type`	`summary` - `season`	String	Type of the season `REG`
`year`	`summary` - `season`	Integer	Year of the season
`id`	`summary` - `week`	GUID	Unique week ID ex. `c5b272b0-388f-496d-ab6f-0a341b0a116b`
`sequence`	`summary` - `week`	Integer	Week sequence number
`title`	`summary` - `week`	String	Week title ex. `10`

Metadata

Attribute	Parent Element	Type	Description
`league`	`metadata`	String	Alias of a league ex. `ncaafb`
`locale`	`metadata`	String	Language code ex. `en` (English)
`match`	`metadata`	GUID	Unique ID(s) of a game ex. `sd:match:42f7d659-23aa-4260-b6be-0c5f9fd0eb53,sr:match:27653180`
`operation`	`metadata`	String	Operation of an update `update`, `delete`
`participant`	`metadata`	GUID	Unique ID(s) of a team or player ex. `sd:team:4eb165ff-ebe8-4a9e-8a57-34ec90f112e4`
`status`	`game`	String	Game status `scheduled`, `created`, `inprogress`, `halftime`, `complete`, `closed`, `cancelled`, `postponed`, `delayed`, `suspended`, `flex-schedule`, `time-tbd` See our NCAAFB FAQ for game status descriptions
`version`	`metadata`	String	Version of the API ex. `v7`

Player

Attribute	Parent Element	Type	Description
`id`	`player`	GUID	Unique ID of a player ex. `4be48c57-4b7c-46ad-8535-445c195feda6`
`jersey`	`player`	String	Jersey number of a player
`name`	`player`	String	Full name of a player ex. `Stetson Bennett`
`position`	`player`	String	Position of a player See our FAQ for a list of valid positions

Standings

Attribute	Parent Element	Type	Description
`losses`	`home` / `away` - `record`	Integer	Number of team losses year-to-date before the game. Record is updated post-game based on the game outcome
`wins`	`home` / `away` - `record`	Integer	Number of team wins year-to-date before the game. Record is updated post-game based on the game outcome

Team

| Attribute | Parent Element | Type | Description | | --------- | -------------- | ---- | ----------- || | alias | team | String | Team alias

ex. IOW (University of Iowa) | | id | team | GUID | Unique ID of a team

ex. a2ee495d-37c7-45ac-ac3d-d3a492a219c1 | | market | team | String | Team market name

ex. Iowa | | name | team | String | Team name

ex. Hawkeyes |

Venue

Attribute	Parent Element	Type	Description
`address`	`summary` - `venue`	String	Address of a venue ex. `886 Stadium Drive`
`capacity`	`summary` - `venue`	Integer	Capacity of a venue ex. `69250`
`city`	`summary` - `venue`	String	City of a venue ex. `Iowa City`
`country`	`summary` - `venue`	String	Country of a venue ex. `USA`
`id`	`summary` - `venue`	GUID	Unique ID of a venue ex. `967ef86b-d0de-49b7-8984-61f95104d30d`
`lat`	`venue` - `location`	Decimal	Latitude of a venue ex. `41.6587`
`lng`	`venue` - `location`	Decimal	Longitude of a venue ex. `-91.5511`
`name`	`summary` - `venue`	String	Name of a venue ex. `Kinnick Stadium`
`roof_type`	`summary` - `venue`	String	Roof type of a venue `outdoor`, `dome`, `retractable_dome`
`state`	`summary` - `venue`	String	State of a venue ex. `IA`
`surface`	`summary` - `venue`	String	Surface type of a venue `turf`, `artificial`, `outdoor`
`zip`	`summary` - `venue`	Integer	ZIP code of a venue ex. `52242`