Game Boxscore

Time	Status	User Agent
Retrieving recent requests…

⏱️
Update Frequency
TTL / Cache:

60 seconds when a game is in scheduled status

3 seconds when a game moves to inprogress

600 seconds when a game moves to closed

30 minutes when seven days have passed since closed

Data Updates: Realtime
Recommended Pull (Non-Live): Pull on an as-needed basis. Feed can be ignored until 10 minutes before the scheduled game start, depending on your use case. Utilize the daily change log to capture data changes after a game has ended.
Recommended Pull (Live): Can request as fast as every 3 seconds (matching the TTL) when a game is live. Game feeds should be requested 10 minutes before the scheduled start. Use the expected_latency field to determine how many this feed may lag behind live play.

📘
Tracking Live Games
Learn how to use the Game Boxscore for live scoring updates, scores by quarter, and situation detail in our Tracking Live Games integration scenario.

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`
`deleted`	`game`	Boolean	Signifies a game was deleted when `true`
`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`
`stadium_status`	`weather`	String	Indicates whether a stadium's roof is open or closed. Omitted from the response when not applicable. `open`, `closed`
`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 Sack yardage can include halves when players share a sack
`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`

Update Frequency

Tracking Live Games

Data Points

200200