⏱️
Update Frequency
TTL / Cache: This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.
Data Updates: Realtime

Data Points

Boxscore

Attribute	Parent Element	Type	Description
`attendance`	`game`	Integer	Attendance of a game ex. `73242`
`decision`	`coin_toss` - `away`	String	Away team coin toss decision `kick`, `receive`, `defer`
`direction`	`coin_toss` - `away`	String	Away team coin toss direction chosen `kick`, `receive`, `defer`
`outcome`	`coin_toss` - `away`	String	Away team coin toss outcome `won`, `lost`
`away_points`	`scoring` - `quarter`	Integer	Away team points in a quarter
`remaining_challenges`	`away`	Integer	Away team challenges remaining
`remaining_timeouts`	`away`	Integer	Away team timeouts remaining
`used_challenges`	`away`	Integer	Away team challenges used
`used_timeouts`	`away`	Integer	Away team timeouts used
`points`	`away`	Integer	Away team total points
`clock`	`game`	String	Clock value of the game ex. `12:37`
`quarter`	`coin_toss`	String	Coin toss within a period. A coin toss will occur at the start of the game, half (period 3), and overtimes (periods 5+)
`decision`	`coin_toss` - `home`	String	Home team coin toss decision `defer`, `receive`
`direction`	`coin_toss` - `home`	String	Home team coin toss direction chosen `kick`, `receive`
`outcome`	`coin_toss` - `home`	String	Home team coin toss outcome `won`, `lost`
`home_points`	`scoring` - `quarter`	Integer	Home team points in a quarter
`remaining_challenges`	`home`	Integer	Home team challenges remaining
`remaining_timeouts`	`home`	Integer	Home team timeouts remaining
`used_challenges`	`home`	Integer	Home team challenges used
`used_timeouts`	`home`	Integer	Home team timeouts used
`points`	`home`	Integer	Home team total points
`away_points`	`scoring` - `overtime`	Integer	Away team points in overtime
`home_points`	`scoring` - `overtime`	Integer	Home team points in overtime
`id`	`overtime`	GUID	Unique ID of overtime
`number`	`overtime`	Integer	Overtime number
`sequence`	`overtime`	Integer	Period sequence number (The first overtime sequence would be `5`)
`quarter`	`game`	Integer	Quarter number of the game
`id`	`quarter`	GUID	Unique ID of a quarter ex. `47091cc4-08c2-4f83-9d8d-59c3c85e1725`
`number`	`quarter`	Integer	Quarter number
`sequence`	`quarter`	Integer	Period sequence number

Boxscore - Current Situation

This situation node will provide the current down, distance, possession, and ball location for a game. For example: 3rd and 13 for the Hawkeyes at their own 22 yardline

Attribute	Parent Element	Type	Description
`clock`	`situation`	String	End clock value of the last completed play ex. `12:37`
`down`	`situation`	Integer	Current down
`yfd`	`situation`	Integer	Current yards to gain for a first down
`alias`	`situation` - `location`	Integer	Team alias of the current ball location ex. `IOW` (University of Iowa)
`id`	`situation` - `location`	Integer	Unique team ID of the current ball location ex. `a2ee495d-37c7-45ac-ac3d-d3a492a219c1`
`market`	`situation` - `location`	Integer	Team market name of the current ball location ex. `Iowa`
`name`	`situation` - `location`	Integer	Team name of the current ball location ex. `Hawkeyes`
`yardline`	`situation` - `location`	Integer	Current yardline
`alias`	`situation` - `possession`	Integer	Team alias of the team with the ball ex. `IOW` (University of Iowa)
`id`	`situation` - `possession`	Integer	Unique team ID of the team with the ball ex. `a2ee495d-37c7-45ac-ac3d-d3a492a219c1`
`market`	`situation` - `possession`	Integer	Team market name of the team with the ball ex. `Iowa`
`name`	`situation` - `possession`	Integer	Team name of the team with the ball ex. `Hawkeyes`

Boxscore - Last Event

Attribute	Parent Element	Type	Description
`clock`	`last_event` - `play`	String	Clock value for the previous event ex. `12:37`
`created_at`	`last_event` - `play`	Date/Time	Timestamp of the creation of an event ex. `2022-09-20T00:54:16+00:00`
`deleted`	`last_event` - `play`	Boolean	Signifies the last event was deleted
-	`last_event` - `description`	Boolean	Text description of an event ex. `K.Mozee for 1 yards, TOUCHDOWN.`
`id`	`last_event` - `play`	String	Unique ID of an event ex. `fd790d30-4e81-11ed-b357-5954f3d7fdac`
`sequence`	`last_event` - `play`	Decimal	Sequence number of an event or play. Used to sequence events properly ex. `1665336878436.0`
`type`	`last_event` - `play`	String	Type of play `pass`, `rush`, `faircatch_kick`, `extra_point`, `conversion`, `free_kick`, `kickoff`, `punt`, `field_goal`, `penalty`
`updated_at`	`last_event` - `play`	Date/Time	Timestamp of the last update of a play ex. `2022-09-20T00:54:16+00:00`
`wall_clock`	`last_event` - `play`	Date/Time	Timestamp of the start of the play/event entry ex. `2022-10-09T17:12:08+00:00`

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`
`cable`	`broadcast`	String	Number of a game's broadcast cable station ex. `822`
`internet`	`broadcast`	String	Name of a game's internet stream ex. `ESPN+`
`network`	`broadcast`	String	Name of a game's broadcast network ex. `Amazon Prime Video`
`radio`	`broadcast`	String	Name of a game's radio station ex. `Sirius 134, XM 231`
`satellite`	`broadcast`	String	Name of a game's broadcast satellite station ex. `ESPN Ocho`
`conference_game`	`game`	Boolean	Signifies an in-Conference matchup ex. (SEC vs. SEC)
`coverage`	`game`	String	Coverage level of a game `full`, `extended_boxscore`
`duration`	`game`	String	Duration of a game ex. `2:52`
`entry_mode`	`game`	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`
`game_type`	`game`	String	Type of game `regular`, `conference_championship`, `bowl`, `playoff`
`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`	`game`	GUID	Unique ID of a game ex. `c9686716-f48a-4667-996d-97639429d8c3`
`neutral_site`	`game`	Boolean	Signifies a game is held at a neutral site
`playoff_game_type`	`game`	String	Name of a playoff game type See our FAQ for a list of valid playoff game types
`parent_id`	`game`	GUID	Standard parent ID of a game. Use this ID to group events (like bowl games) across seasons.
`scheduled`	`game`	Date/Time	Scheduled date and time of a game ex. `2022-09-25T20:10:00+00:00`
`sr_id`	`game`	String	Unique Sportradar ID of a game ex. `sr:match:38354639`
`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
`title`	`game`	String	Game title ex. `CFP National Championship`
`away`	`time_zones`	String	Time zone of the away team ex. `US/Pacific`
`home`	`time_zones`	String	Time zone of the home team ex. `US/Eastern`
`venue`	`time_zones`	String	Time zone of the venue ex. `US/Eastern`
`condition`	`weather`	String	Weather condition for a game ex. `Partly cloudy`, `Clear`, `Light Rain, Mist` Click here for more info on weather condition values
`humidity`	`weather`	Byte	Humidity conditions for a game ex. `44`
`temp`	`weather`	Byte	Temperature of a game in Fahrenheit ex. `57`
`direction`	`wind`	String	Wind direction for a game ex. `N`
`speed`	`wind`	Byte	Wind speed for a game in MPH

League

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

Play-by-Play Details

Attribute	Parent Element	Type	Description
`category`	`detail`	String	Play detail category ex. `kick_off`, `kick_off_return`, `tackle`, `rush`
`description`	-	String	Text description of a play
`direction`	`detail`	String	Direction of action for a play Rush: `short left`, `short right`, `short middle`, `deep right`, `deep left`, `deep middle`, `left`, `right`, `middle` Pass: `backward pass`, `handoff`, `lateral`, `reverse`, `left tackle`, `left guard`, `up the middle`, `right guard`, `right tackle`, `right end`, `left end`, `kneels`
`alias`	`end_location`	String	Team alias of the location of the ball at the conclusion of a play ex. `UGA` (University of Georgia)
`yardline`	`end_location`	Integer	Yardline location of the ball at the conclusion of a play ex. `45`
`description`	`penalty`	String	Text description of a penalty ex. `PENALTY on TCU-T.Hodges-Tomlinson, Defensive Pass Interference, 15 yards, accepted.`
`result`	`penalty`	String	Result of a penalty `accepted`, `declined`, `offset`
`yards`	`penalty`	Integer	Number of yards penalized on the play
`result`	`detail`	String	Result of the play ex. `tackled`, `touchdown`
`sequence`	`detail`	Integer	Sequence number of the play detail
`alias`	`start_location`	String	Team alias of the location of the ball at the beginning of a play ex. `UGA` (University of Georgia)
`yardline`	`start_location`	Integer	Yardline location of the ball at the beginning of a play ex. `45`
`yards`	`detail`	Integer	Yards gained or lost on the play

Play-by-Play Details - Review

Attribute	Parent Element	Type	Description
`result`	`detail` - `review`	String	Result of a play review/challenge `overturned`, `upheld`
`reversed`	`detail` - `review`	Boolean	Signifies the call on the field was reversed when `true`
`type`	`detail` - `review`	String	Type of a play review/challenge ex. `first down`, `pass completion`, `short of the line to gain` See our FAQ for a complete list of valid types.
`alias`	`detail` - `review` - `team`	String	Alias of a team initiating a review/challenge ex. `IOW` (University of Iowa)
`id`	`detail` - `review` - `team`	GUID	Unique ID of a team initiating a review/challenge ex. `a2ee495d-37c7-45ac-ac3d-d3a492a219c1`
`market`	`detail` - `review` - `team`	String	Market name of a team initiating a review/challenge ex. `Iowa`
`name`	`detail` - `review` - `team`	String	Name of a team initiating a review/challenge ex. `Hawkeyes`

Play-by-Play Details - Recovery

Attribute	Parent Element	Type	Description
`type`	`detail` - `recovery`	String	Type of recovery `ball out of bounds`, `blocked kick recovery`, `dead ball declared`, `fumble recovery`, `interception`, `other team`, `other_team`, `same player`, `same team`
`alias`	`detail` - `recovery` - `team`	String	Alias of a team recovering the ball ex. `IOW` (University of Iowa)
`id`	`detail` - `recovery` - `team`	GUID	Unique ID of a team recovering the ball ex. `a2ee495d-37c7-45ac-ac3d-d3a492a219c1`
`market`	`detail` - `recovery` - `team`	String	Market name of a team recovering the ball ex. `Iowa`
`name`	`detail` - `recovery` - `team`	String	Name of a team recovering the ball ex. `Hawkeyes`

Play-by-Play Drive

Attribute	Parent Element	Type	Description
`created_at`	`drive`	Date/Time	Timestamp of the start of a drive ex. `2023-01-01T02:10:21+00:00`
`id`	`drive` - `defensive_team`	GUID	Unique ID of the defensive team on a drive ex. `2eef738d-c637-4b12-b8df-4b79efcce71e`
`points`	`drive` - `defensive_team`	Integer	Number of points scored for the defensive team on a drive
`id`	`drive` - `offensive_team`	GUID	Unique ID of the defensive team on a drive ex. `2eef738d-c637-4b12-b8df-4b79efcce71e`
`points`	`drive` - `offensive_team`	Integer	Number of points scored for the defensive team on a drive
`duration`	`drive`	String	Duration of a drive in `MM:SS` format
`end_clock`	`drive`	String	Clock value at the end of a drive ex. `6:07`
`end_reason`	`drive`	String	End result of a drive ex. `Touchdown` See our FAQ for a list of valid end reasons and their definitions
`farthest_drive_yardline`	`drive`	Integer	The furthest yardline the offensive team reached during a drive (1-99 scale)
`first_downs`	`drive`	Integer	Number of first downs in a drive
`first_drive_yardline`	`drive`	Integer	Starting yardline of the first play of a drive (1-99 scale)
`gain`	`drive`	Integer	Number of yards gained in a drive
`id`	`drive`	GUID	Unique ID of a drive
`inside_20`	`drive`	Boolean	Signifies a drive which ends inside the opponent's 20 yardline
`last_drive_yardline`	`drive`	Integer	Starting yardline of the last play of a drive (1-99 scale)
`net_yards`	`drive`	Integer	Net yards gained on a drive
`pat_points_attempted`	`drive`	Integer	Number of PAT points attempted on a drive
`pat_points_attempted`	`drive`	Integer	Number of PAT points attempted on a drive
`pat_successful`	`drive`	Boolean	Signifies a successful PAT attempt on a drive
`penalty_yards`	`drive`	Integer	Number of penalty yards on a drive
`play_count`	`drive`	Integer	Number of plays in a drive
`scoring_drive`	`drive`	Boolean	Signifies a drive which ends in a score
`sequence`	`drive`	Integer	Sequential number of the drive within a game
`start_clock`	`drive`	String	Clock value at the beginning of a drive ex. `6:07`
`start_reason`	`drive`	String	Start reason of a drive ex. `Interception` See our FAQ for a list of valid start reasons and their definitions
`team_sequence`	`drive`	Integer	Sequential number of a drive for the offensive team
`updated_at`	`drive`	Date/Time	Timestamp of the last update of a drive ex. `2023-01-01T04:04:45+00:00`

Play-by-Play Ending Situation

Attribute	Parent Element	Type	Description
`clock`	`end_situation`	String	Game clock value at the end of a play ex. `14:55`
`down`	`end_situation`	Integer	Down at the end of a play
`alias`	`end_situation` - `location`	String	Team alias of the location of the ball at the end of a play ex. `UGA` (University of Georgia)
`id`	`end_situation` - `location`	GUID	Unique team ID of the team with possession at the end of a play ex. `2eef738d-c637-4b12-b8df-4b79efcce71e`
`market`	`end_situation` - `location`	String	Team market name ex. `Georgia`
`name`	`end_situation` - `location`	String	Team name ex. `Bulldogs`
`yardline`	`end_situation` - `location`	Integer	Yardline of the ball at the end of a play
`alias`	`end_situation` - `possession`	String	Team alias of the possession of the ball at the end of a play ex. `UGA` (University of Georgia)
`id`	`end_situation` - `possession`	GUID	Unique team ID of the team with possession at the end of a play ex. `2eef738d-c637-4b12-b8df-4b79efcce71e`
`market`	`end_situation` - `possession`	String	Team market name ex. `Georgia`
`name`	`end_situation` - `possession`	String	Team name ex. `Bulldogs`
`yfd`	`end_situation`	Integer	Yards to gain a first down at the end of a play

Play-by-Play Event

Attribute	Parent Element	Type	Description
`clock`	`event`	String	Clock value for an event ex. `12:37`
`created_at`	`event`	Date/Time	Timestamp of the creation of an event ex. `2022-09-20T00:54:16+00:00`
`description`	-	String	Text description of an event ex. `End Game`
`id`	`event`	String	Unique ID of an event ex. `cfb655f0-909a-11ed-aba5-e52871d6dcff`
`sequence`	`event`	Decimal	Sequence number of an event or play. Used to sequence events properly ex. `1665336878436.0`
`type`	`event`	String	Type of an event `setup`, `timeout`, `tv_timeout`, `two_minute_warning`, `comment`, `period_end`, `game_over`
`updated_at`	`event`	Date/Time	Timestamp of the last update of an event ex. `2022-09-20T00:54:16+00:00`
`wall_clock`	`event`	Date/Time	Timestamp of a play/event entry ex. `2022-10-09T17:12:08+00:00`

Play-by-Play - Play

Attribute	Parent Element	Type	Description
`away_points`	`play`	Integer	Away points at the end of a play
`clock`	`play`	String	Clock value for a play ex. `12:37`
`created_at`	`play`	Date/Time	Timestamp of the creation of a play ex. `2022-09-20T00:54:16+00:00`
`description`	-	String	Text description of a play ex. `C.Stroud scrambles to UGA 31 for 27 yards. Tackled by D.Daniel-Sisavanh at UGA 31.`
`fake_field_goal`	`play`	Boolean	Signifies whether the a play was a fake field goal
`fake_punt`	`play`	Boolean	Signifies whether the a play was a fake punt
`goaltogo`	`play`	Boolean	Signifies a play was goal-to-go (eg. 1st & Goal, 2nd & Goal, etc.) when `true`
`home_points`	`play`	Integer	Home points at the end of a play
`id`	`play`	GUID	Unique ID of a play ex. `3ad11b50-898d-11ed-aacf-3187fb36aa01`
`official`	`play`	Boolean	Signifies whether or not a play is under review. If `false`, the play is currently under review. If `true`, a determination on the play has been made.
`scoring-description`	-	String	Text description of a scoring play ex. `S.Bennett rushed left end to TCU End Zone for 21 yards. S.Bennett for 21 yards, TOUCHDOWN.`
`scoring_play`	`play`	Boolean	Signifies whether a play resulted in a score
`sequence`	`play`	Decimal	Sequence number of an event or play. Used to sequence events properly ex. `1665336878436.0`
`type`	`play`	String	Type of play `pass`, `rush`, `faircatch_kick`, `extra_point`, `conversion`, `free_kick`, `kickoff`, `punt`, `field_goal`, `penalty`
`updated_at`	`play`	Date/Time	Timestamp of the last update of a play ex. `2022-09-20T00:54:16+00:00`
`wall_clock`	`play`	Date/Time	Timestamp of the start of the play/event entry ex. `2022-10-09T17:12:08+00:00`

Play-by-Play Points After

Attribute	Parent Element	Type	Description
`id`	`points-after-play`	GUID	Unique ID of a point after attempt ex. `a397a7c0-47f8-11ed-972d-8539f16b8bbf`
`type`	`points-after-play`	String	Type of a point after attempt `extra_point`, `conversion`, `penalty`
`sequence`	`points-after-play`	Decimal	Sequence number of an event or play. Used to sequence events properly ex. `1665336878436.0`

Play-by-Play Quarter

Attribute	Parent Element	Type	Description
`id`	`quarter`	GUID	Unique ID of a quarter ex. `47091cc4-08c2-4f83-9d8d-59c3c85e1725`
`number`	`quarter`	Integer	Number of a quarter
`sequence`	`quarter`	Integer	Sequential number of a quarter
`id`	`overtime`	GUID	Unique ID of overtime
`number`	`overtime`	Integer	Overtime number
`sequence`	`overtime`	Integer	Period sequence number (The first overtime sequence would be `5`)

Play-by-Play Scoring

Attribute	Parent Element	Type	Description
`away_points`	`score`	Integer	Number of away team points
`clock`	`score`	Boolean	Clock value for a score ex. `12:37`
`home_points`	`score`	Integer	Number of home team points
`points`	`score`	Integer	Number of points for a score
`sequence`	`score`	Integer	Sequence number of an event or play. Used to sequence events properly ex. `1665336878436.0`

Play-by-Play Starting Situation

Attribute	Parent Element	Type	Description
`clock`	`start_situation`	String	Clock value at the start of a play ex. `12:37`
`down`	`start_situation`	Integer	Down at the start of a play
`alias`	`location`	String	Team alias of the location of the ball at the start of a play ex. `OSU` (Ohio State University)
`id`	`start_situation` - `location`	GUID	Unique team ID of the team with possession at the start of a play ex. `9a6d6f3f-021e-4ddd-8fac-ac4766239d87`
`market`	`start_situation` - `location`	String	Team market name ex. `Ohio State`
`name`	`start_situation` - `location`	String	Team name ex. `Buckeyes`
`yardline`	`start_situation` - `location`	Integer	Yardline of the ball at the start of a play
`alias`	`start_situation` - `possession`	String	Team alias of the possession of the ball at the start of a play ex. `OSU` (Ohio State University)
`id`	`start_situation` - `possession`	GUID	Unique team ID of the team with possession at the start of a play ex. `9a6d6f3f-021e-4ddd-8fac-ac4766239d87`
`market`	`start_situation` - `possession`	String	Team market name ex. `Ohio State`
`name`	`start_situation` - `possession`	String	Team name ex. `Buckeyes`
`yfd`	`end_situation`	Integer	Yards to gain a first down at the start of a play

Kick & Punt Block Play Statistics

Attribute	Parent Element	Type	Description
`block`	`block`	Integer	Number kick blocks
`category`	`block`	String	Type of blocked kick `field_goal`, `extra_point`, `punt`
`nullified`	`block`	Boolean	Signifies the statisic is nullified

Conversion Play Statistics

Attribute	Parent Element	Type	Description
`attempt`	`conversion`	Integer	Number of conversion attempts
`category`	`conversion`	String	Category of conversion `pass`, `receive`, `rush`, `turnover`
`complete`	`conversion`	Integer	Number of conversion completions
`nullified`	`conversion`	Boolean	Signifies the statisic is nullified
`safety`	`conversion`	Integer	Number of conversion safeties

Defensive Play Statistics

Attribute	Parent Element	Type	Description
`ast_sack`	`defense`	Integer	Number of assisted sacks
`ast_tackle`	`defense`	Integer	Number of assisted tackles
`ast_tlost`	`defense`	Integer	Number of assisted tackles for a loss
`block`	`defense`	Integer	Number of blocked kicks/punts
`category`	`defense`	String	Category of defensive statistic `defense`, `special_team`, `misc`
`forced_fumble`	`defense`	Integer	Number of forced fumbles
`interception`	`defense`	Integer	Number of interceptions
`int_touchdown`	`defense`	Integer	Number of interceptions for a touchdown
`int_yards`	`defense`	Integer	Number of interception yards
`nullified`	`defense`	Boolean	Nullified play flag
`pass_defended`	`defense`	Integer	Number of passes defended
`primary`	`defense`	Integer	Indicates whether the assist tackler was the primary tackler on a play *This stat is unsupported since 2021
`qb_hit`	`defense`	Integer	Number of hits on the quarterback
`sack`	`defense`	Integer	Number of sacks
`sack_yards`	`defense`	Decimal	Number of sack yards
`safety`	`defense`	Integer	Number of safeties
`tlost`	`defense`	Integer	Number of tackles for a loss
`tlost_yards`	`defense`	Integer	Number of tackles for a loss yardage
`tackle`	`defense`	Integer	Number of tackles

Defensive Conversion Play Statistics

Attribute	Parent Element	Type	Description
`attempt`	`defense_conversion`	Integer	Number of defensive conversion attempts
`category`	`defense_conversion`	String	Category of defensive conversion `conversion`, `extra_point`
`complete`	`defense_conversion`	Integer	Number of defensive conversion completions
`nullified`	`defense_conversion`	Boolean	Signifies the statisic is nullified

Down Conversion Play Statistics

Attribute	Parent Element	Type	Description
`attempt`	`down_conversion`	Integer	Number of down conversion attempts
`complete`	`down_conversion`	String	Category of down conversion `conversion`, `extra_point`
`down`	`down_conversion`	Integer	Number of the down at play start
`category`	`first_down`	String	Type of first down `pass`, `rush`, `penalty`
`nullified`	`first_down`	Boolean	Signifies the first down is nullified
`nullified`	`defense_conversion`	Boolean	Signifies the statisic is nullified

Extra Point Play Statistics

Attribute	Parent Element	Type	Description
`attempt`	`extra_point`	Integer	Number of attempted extra points
`blocked`	`extra_point`	Integer	Number of blocked extra points
`made`	`extra_point`	Integer	Number of made extra points
`missed`	`extra_point`	Integer	Number of missed extra points
`nullified`	`extra_point`	Boolean	Signifies the statisic is nullified
`returned`	`extra_point`	Integer	Number of returned extra points
`safety`	`extra_point`	Integer	Number of extra point safeties

Field Goal Play Statistics

Attribute	Parent Element	Type	Description
`attempt`	`field_goal`	Integer	Number of attempted field goals
`att_yards`	`field_goal`	Integer	Yardage of attempted field goal
`blocked`	`field_goal`	Integer	Number of blocked field goals
`made`	`field_goal`	Integer	Number of made field goals
`missed`	`field_goal`	Integer	Number of missed field goals
`nullified`	`field_goal`	Boolean	Signifies a nullified field goal attempt
`returned`	`field_goal`	Integer	Number of returned field goals
`yards`	`field_goal`	Integer	Yardage of made field goal

Fumbles Play Statistics

Attribute	Parent Element	Type	Description
`forced`	`fumble`	Integer	Number of forced fumbles
`fumble`	`fumble`	Integer	Number of fumbles
`lost`	`fumble`	Integer	Number of lost fumbles
`nullified`	`fumble`	Boolean	Signifies a nullified play due to a penalty
`opp_rec`	`fumble`	Integer	Number of opponent fumble recoveries
`opp_rec_td`	`fumble`	Integer	Number of opponent fumble recovery touchdowns
`opp_rec_yards`	`fumble`	Integer	Number of opponent fumble recovery yards
`out_of_bounds`	`fumble`	Integer	Number of fumbles out of bounds
`own_rec`	`fumble`	Integer	Number of own fumble recoveries
`own_rec_td`	`fumble`	Integer	Number of own fumble recovery touchdowns
`own_rec_yards`	`fumble`	Integer	Number of own fumble recovery yards
`play_category`	`fumble`	String	Type of fumble ex. `misc`

Kickoff Play Statistics

Attribute	Parent Element	Type	Description
`attempt`	`kick`	Integer	Number of kickoff attempts
`endzone`	`kick`	Integer	Number of kicks into the endzone
`inside_20`	`kick`	Integer	Number of kicks inside the 20 yardline
`net_yards`	`kick`	Integer	Number of net yards on the kickoff
`nullified`	`kick`	Boolean	Signifies a nullified play due to a penalty
`onside_attempt`	`kick`	Boolean	Number of onside kickoff attempts
`onside_success`	`kick`	Boolean	Number of onside kickoff successes
`own_rec`	`kick`	Boolean	Number of own recoveries on a kickoff
`own_rec_td`	`kick`	Boolean	Number of own recovery touchdowns on a kickoff
`squib_kick`	`kick`	Boolean	Number of squib kicks
`touchback`	`kick`	Boolean	Number of touchbacks
`yards`	`kick`	Boolean	Number of kickoff yards

Passing Play Statistics

Attribute	Parent Element	Type	Description
`attempt`	`pass`	Integer	Number of pass attempts
`complete`	`pass`	Integer	Number of pass completions
`firstdown`	`pass`	Integer	Number of passing first downs
`goaltogo`	`pass`	Integer	Number of plays in a goal-to-go situation (eg. 1st & Goal, 2nd & Goal, etc.)
`inside_20`	`pass`	Integer	Number of passes inside the 20 yardline
`interception`	`pass`	Integer	Number of interceptions thrown
`int_touchdown`	`pass`	Integer	Number of interception touchdowns thrown
`nullified`	`pass`	Boolean	Signifies a nullified play due to a penalty
`sack`	`pass`	Integer	Number of sacks
`sack_yards`	`pass`	Integer	Number of sack yards
`safety`	`pass`	Integer	Number of safeties
`touchdown`	`pass`	Integer	Number of touchdowns
`yards`	`pass`	Integer	Number of passing yards

Penalty Play Statistics

Attribute	Parent Element	Type	Description
`penalty`	`penalty`	Integer	Number of penalties
`yards`	`penalty`	Integer	Number of penalty yardage

Punting Play Statistics

Attribute	Parent Element	Type	Description
`attempt`	`punt`	Integer	Number of attempted punts
`blocked`	`punt`	Integer	Number of blocked punts
`endzone`	`punt`	Integer	Number of punts into the endzone
`inside_20`	`punt`	Integer	Number of punts inside the 20 yardline
`net_yards`	`punt`	Integer	Net yardage of a punt
`nullified`	`punt`	Boolean	Signifies a nullified play due to a penalty
`touchback`	`punt`	Integer	Number of touchback punts
`yards`	`punt`	Integer	Yardage of punt

Receiving Play Statistics

Attribute	Parent Element	Type	Description
`firstdown`	`receive`	Integer	Number of receiving first downs
`fumble`	`receive`	Integer	Number of receiving fumbles
`goaltogo`	`receive`	Integer	Number of receptions in a goal-to-go situation (eg. 1st & Goal, 2nd & Goal, etc.)
`inside_20`	`receive`	Integer	Number of receptions inside the 20 yardline
`nullified`	`receive`	Boolean	Signifies a nullified play due to a penalty
`reception`	`receive`	Integer	Number of receptions
`safety`	`receive`	Integer	Number of receiving safeties
`targets`	`receive`	Integer	Number of receiving targets
`touchdown`	`receive`	Integer	Number of receiving touchdowns
`yards`	`receive`	Integer	Number of receiving yards
`yards_after_catch`	`receive`	Integer	Number of receiving yards after the catch Yards after catch is not currently a collected statistic for NCAA Football

Return Play Statistics

Attribute	Parent Element	Type	Description
`category`	`return`	String	Type of return `punt_return`, `kick_return`
`faircatch`	`return`	Integer	Number of return fair catches
`nullified`	`return`	Boolean	Signifies a nullified play due to a penalty
`return`	`return`	Integer	Number of returns
`touchback`	`return`	Integer	Number of return touchbacks
`touchdown`	`return`	Integer	Number of return touchdowns
`yards`	`return`	Integer	Number of return yardage

Rushing Play Statistics

Attribute	Parent Element	Type	Description
`attempt`	`rush`	Integer	Number of rushing attempts
`firstdown`	`rush`	Integer	Number of rushing first downs
`fumble`	`rush`	Integer	Number of rushing fumbles
`goaltogo`	`rush`	Integer	Number of rushes in a goal-to-go situation (eg. 1st & Goal, 2nd & Goal, etc.)
`inside_20`	`rush`	Integer	Number of rushes inside the 20 yardline
`nullified`	`rush`	Boolean	Signifies a nullified play due to a penalty
`safety`	`rush`	Integer	Number of rushing safeties
`tlost`	`rush`	Integer	Number of rushing tackles for a loss
`tlost_yards`	`rush`	Integer	Number of rushing tackles for a loss yardage
`touchdown`	`rush`	Integer	Number of rushing touchdowns
`yards`	`rush`	Integer	Number of rushing yards

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
`role`	`player`	String	Role of a player during a specific play ex. `pass`, `receive`, `tackle`, `rush`, `defend`, `catch`, `ast_tackle`, `kick`, `return`, `penalty`

Team Records

Team win-loss-tie data is added after a game moves to complete status. It is not present prior to or during a game.

Attribute	Parent Element	Type	Description
`losses`	`record`	Integer	Number of team losses year-to-date after a game
`ties`	`record`	Integer	Number of team ties year-to-date after a game
`wins`	`record`	Integer	Number of team wins year-to-date after a game

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`	`venue`	String	Address of a venue ex. `886 Stadium Drive`
`capacity`	`venue`	Integer	Capacity of a venue ex. `69250`
`city`	`venue`	String	City of a venue ex. `Iowa City`
`country`	`venue`	String	Country of a venue ex. `USA`
`id`	`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`	`venue`	String	Name of a venue ex. `Kinnick Stadium`
`roof_type`	`venue`	String	Roof type of a venue `outdoor`, `dome`, `retractable_dome`
`state`	`venue`	String	State of a venue ex. `IA`
`surface`	`venue`	String	Surface type of a venue `turf`, `artificial`, `outdoor`
`zip`	`venue`	Integer	ZIP code of a venue ex. `52242`