⏱️
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

4 hours when seven days have passed since closed

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`
`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 overtime
`decision`	`coin_toss` - `home`	String	Home team coin toss decision `defer`, `receive`, `defer`
`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 Chargers 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. `MIN` (Minnesota)
`id`	`situation` - `location`	Integer	Unique team ID of the current ball location ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`market`	`situation` - `location`	Integer	Team market name of the current ball location ex. `Minnesota`
`name`	`situation` - `location`	Integer	Team name of the current ball location ex. `Vikings`
`sr_id`	`situation` - `location`	Integer	Unique Sportradar ID of a team of the current ball location ex. `sr:competitor:4324`
`yardline`	`situation` - `location`	Integer	Current yardline
`alias`	`situation` - `possession`	Integer	Team alias of the team with the ball ex. `MIN` (Minnesota)
`id`	`situation` - `possession`	Integer	Unique team ID of the team with the ball ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`market`	`situation` - `possession`	Integer	Team market name of the team with the ball ex. `Minnesota`
`name`	`situation` - `possession`	Integer	Team name of the team with the ball ex. `Vikings`
`sr_id`	`situation` - `possession`	Integer	Unique Sportradar ID of a team of the team with the ball ex. `sr:competitor:4324`

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
`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. `MIN` (Minnesota)
`id`	`away`	GUID	Unique ID of the away team ex. `768c92aa-75ff-4a43-bcc0-f2798c2e1724`
`market`	`away`	String	Away team market name ex. `Minnesota`
`name`	`away`	String	Away team name ex. `Vikings`
`sr_id`	`away`	String	Unique Sportradar ID of the away team ex. `sr:competitor:4376`
`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. (NFC vs. NFC)
`duration`	`game`	String	Duration of the game ex. `2:52`
`entry_mode`	`game`	String	Type of data entry for the game `LDE` (Live Data Entry)
`game_type`	`game`	String	Type of game `regular`, `playoff`
`alias`	`home`	String	Home team alias ex. `GB` (Green Bay)
`id`	`home`	GUID	Unique ID of the home team ex. `7b112545-38e6-483c-a55c-96cf6ee49cb8`
`market`	`home`	String	Home team market name ex. `Green Bay`
`name`	`home`	String	Home team name ex. `Packers`
`sr_id`	`home`	String	Unique Sportradar ID of the home team ex. `sr:competitor:4391`
`id`	`game`	GUID	Unique ID of a game ex. `13025660-aa95-4885-b33e-3a3554d4c4c3`
`neutral_site`	`game`	Boolean	Signifies a game is held at a neutral site when `true`
`number`	`game`	Integer	Game number
`parent_id`	`game`	GUID	Standard parent ID of a game. Use this ID to group events (like the Super Bowl) 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:33623305`
`status`	`game`	String	Game status `scheduled`, `created`, `inprogress`, `complete`, `closed`, `cancelled`, `delayed`, `suspended`, `postponed`, `time-tbd`, `if necessary`, `unnecessary` See our NFL FAQ for game status descriptions
`title`	`game`	String	Game title ex. `NFC 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. `75749c10-56c1-4ae0-9d1e-2689708debdf`
`name`	`season`	String	Name of the season `PRE`, `REG`, `PST`
`type`	`season`	String	Type of the season `PRE`, `REG`, `PST`
`year`	`season`	Integer	Year of the season
`id`	`week`	GUID	Unique week ID ex. `57b447ce-bc66-47f7-9760-89d328d3db9f`
`sequence`	`week`	Integer	Week sequence number
`title`	`week`	String	Week title

Play-by-Play Details

Attribute	Parent Element	Type	Description
`category`	`detail`	String	Play detail category ex. `kick_off`, `kick_off_return`, `tackle`
`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. `MIN` (Minnesota)
`yardline`	`end_location`	Integer	Yardline location of the ball at the conclusion of a play ex. `45`
`first_touch`	`detail`	String	Indicates the yard line where the ball was first touched, after the fumble, but before the ball was recovered (ingested games only)
`no_attempt`	`detail`	String	Indicates if the player should receive a statistical attempt for the process. Generally used on laterals (ingested games only)
`onside`	`detail`	String	Signifies an onside kick
`description`	`penalty`	String	Text description of a penalty
`no_play`	`penalty`	String	Signifies a nullified play due to a penalty
`result`	`penalty`	String	Result of a penalty `accepted`, `declined`, `offset`
`yards`	`penalty`	Integer	Number of yards penalized on the play
`reason_missed`	`detail`	String	Indicates how the kicker missed a field goal attempt: `Blocked, Hit Crossbar`, `Hit Left Upright`, `Hit Right Upright`, `Short`, `Wide Left`, `Wide Right` (ingested games only)
`result`	`detail`	String	Result of the play
`sack_split`	`detail`	String	Indicates if the sack was split by the two defenders (ingested games only)
`safety`	`detail`	Boolean	Signifies a play ending in a safety
`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. `MIN` (Minnesota)
`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. `MIN` (Minnesota)
`id`	`detail` - `review` - `team`	GUID	Unique ID of a team initiating a review/challenge ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`market`	`detail` - `review` - `team`	String	Market name of a team initiating a review/challenge ex. `Minnesota`
`name`	`detail` - `review` - `team`	String	Name of a team initiating a review/challenge ex. `Vikings`
`sr_id`	`detail` - `review` - `team`	String	Unique Sportradar ID of a team initiating a review/challenge ex. `sr:competitor:4324`

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`
`first_touch`	`detail` - `recovery`	Integer	Yard line where a player first touched the ball on a fumble Data point is only supported from 2017-2020
`alias`	`detail` - `recovery` - `team`	String	Alias of a team recovering the ball ex. `MIN` (Minnesota)
`id`	`detail` - `recovery` - `team`	GUID	Unique ID of a team recovering the ball ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`market`	`detail` - `recovery` - `team`	String	Market name of a team recovering the ball ex. `Minnesota`
`name`	`detail` - `recovery` - `team`	String	Name of a team recovering the ball ex. `Vikings`
`sr_id`	`detail` - `recovery` - `team`	String	Unique Sportradar ID of a team recovering the ball ex. `sr:competitor:4324`

Play-by-Play Drive

Attribute	Parent Element	Type	Description
`created_at`	`drive`	Date/Time	Timestamp of the start of a drive
`duration`	`drive`	String	Duration of a drive in `MM:SS` format
`end_clock`	`drive`	String	Game clock value at the end of a drive ex. `9:56`
`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 for the offensive team on a drive (Yards gained minus penalty yards)
`pat_points_attempted`	`drive`	Integer	Number of point after touchdown attempts on a drive
`pat_successful`	`drive`	Boolean	Signifies a successful point after touchdown 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	Game clock value at the start of a drive ex. `4:32`
`start_reason`	`drive`	String	Start reason of a drive
`team_sequence`	`drive`	Integer	Sequential number of the drive for the offensive team
`updated_at`	`drive`	Date/Time	Timestamp of the last update of a drive
`id`	`drive` - `defensive_team`	GUID	Unique ID of the defensive team for a drive ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`points`	`drive` - `defensive_team`	Integer	Number of points scored for the defensive team for a drive
`id`	`drive` - `offensive_team`	GUID	Unique ID of the offensive team for a drive ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`points`	`drive` - `offensive_team`	Integer	Number of points scored for the offensive team for a drive

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. `MIN` (Minnesota)
`id`	`end_situation` - `location`	GUID	Unique team ID of the team with possession at the end of a play ex. `7b112545-38e6-483c-a55c-96cf6ee49cb8`
`market`	`end_situation` - `location`	String	Team market name ex. `Minnesota`
`name`	`end_situation` - `location`	String	Team name ex. `Vikings`
`sr_id`	`end_situation` - `location`	GUID	Unique Sportradar ID of the team with possession at the end of a play ex. `sr:competitor:4423`
`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. `MIN` (Minnesota)
`id`	`end_situation` - `possession`	GUID	Unique team ID of the team with possession at the end of a play ex. `7b112545-38e6-483c-a55c-96cf6ee49cb8`
`market`	`end_situation` - `possession`	String	Team market name ex. `Minnesota`
`name`	`end_situation` - `possession`	String	Team name ex. `Vikings`
`sr_id`	`end_situation` - `possession`	GUID	Unique Sportradar ID of the team with possession at the end of a play ex. `sr:competitor:4423`
`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
`id`	`event`	String	Unique ID of an event
`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 the start 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
`blitz`	`play`	Boolean	Signifies the defense blitzed on a play when `true`
`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. `A.Dillon rushed for 70 yards. TOUCHDOWN. Play is under review.`
`fake_field_goal`	`play`	Boolean	Signifies a play was a fake field goal when `true`
`fake_punt`	`play`	Boolean	Signifies a play was a fake punt when `true`
`goaltogo`	`play`	Boolean	Signifies a play was goal-to-go (eg. 1st & Goal, 2nd & Goal, etc.) when `true`
`hash_mark`	`play`	String	The hash mark of the ball at the beginning of a play `Right Hash`, `Left Hash`
`home_points`	`play`	Integer	Home points at the end of a play
`huddle`	`play`	Boolean	Signifies there was a huddle prior to a play when `true`
`id`	`play`	GUID	Unique ID of a play ex. `bbff5bf0-05a6-11f0-b606-a5cf51051b41`
`left_tightends`	`play`	Integer	Number of tight ends lined up on the left side for a play
`men_in_box`	`play`	Integer	Number of defensive men in the box for a play
`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.
`pass_route`	`play`	String	Type of pass route on a passing play ex. `Flat`, `Slant`, `WR Screen`
`play_action`	`play`	Boolean	Signifies there was a play action for a play when `true`
`play_direction`	`play`	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`
`players_rushed`	`play`	Integer	Number of defensive players rushing for a play
`pocket_location`	`play`	String	Location of the quarterback pocket for a play `Scramble Left`, `Scramble Right`, `Boot Left`, `Boot Right`, `Rollout Left`, `Rollout Right`, `Middle`
`qb_at_snap`	`play`	String	Location of the quarterback at the snap for a play `Shotgun`, `Under Center`, `Pistol`
`right_tightends`	`play`	Integer	Number of tight ends lined up on the right side for a play
`run_pass_option`	`play`	Boolean	Signifies a play is a run/pass option when `true`
`running_lane`	`play`	Integer	Signifies which hole the running back ran through on a rush play (1-8)
`scoring_play`	`play`	Boolean	Signifies a play resulted in a score when `true`
`screen_pass`	`play`	Boolean	Signifies a play is a screen pass when `true`
`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

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. `MIN` (Minnesota)
`id`	`start_situation` - `location`	GUID	Unique team ID of the team with possession at the start of a play ex. `33405046-04ee-4058-a950-d606f8c30852`
`market`	`start_situation` - `location`	String	Team market name ex. `Minnesota`
`name`	`start_situation` - `location`	String	Team name ex. `Vikings`
`sr_id`	`start_situation` - `location`	GUID	Unique Sportradar ID of the team with possession at the start of a play ex. `sr:competitor:4423`
`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. `MIN` (Minnesota)
`id`	`start_situation` - `possession`	GUID	Unique team ID of the team with possession at the start of a play ex. `33405046-04ee-4058-a950-d606f8c30852`
`market`	`start_situation` - `possession`	String	Team market name ex. `Minnesota`
`name`	`start_situation` - `possession`	String	Team name ex. `Vikings`
`sr_id`	`start_situation` - `possession`	GUID	Unique Sportradar ID of the team with possession at the start of a play ex. `sr:competitor:4423`
`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`

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
`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
`batted_pass`	`defense`	Integer	Number of batted passes
`blitz`	`defense`	Integer	Number of blitzes
`block`	`defense`	Integer	Number of blocked kicks/punts
`category`	`defense`	String	Category of defensive statistic `defense`, `special_team`, `misc`
`def_comp`	`defense`	String	Number of completed passes with a defensive player covering on the play
`def_target`	`defense`	Integer	Number of defensive targets
`forced_fumble`	`defense`	Integer	Number of forced fumbles
`hurry`	`defense`	Integer	Number of hurries
`interception`	`defense`	Integer	Number of interceptions
`int_touchdown`	`defense`	Integer	Number of interceptions for a touchdown
`int_yards`	`defense`	Integer	Number of interception yards
`knockdown`	`defense`	Integer	Number of knockdowns
`missed_tackle`	`defense`	Integer	Number of missed tackles
`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

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`

Extra Point Play Statistics

Attribute	Parent Element	Type	Description
`aborted`	`extra_point`	Integer	Number of aborted extra points
`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
`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
`att_yards`	`pass`	Integer	Number of pass attempt (air) yards, measured from the line of scrimmage to the yardline of the receiving target
`batted_pass`	`pass`	Integer	Number of batted passes
`blitz`	`pass`	Integer	Number of blitzes
`complete`	`pass`	Integer	Number of pass completions
`firstdown`	`pass`	Integer	Number of passing first downs
`goaltogo`	`pass`	Integer	Number of pass plays in a goal-to-go situation (eg. 1st & Goal, 2nd & Goal, etc.)
`hurry`	`pass`	Integer	Number of pass hurries
`incompletion_type`	`pass`	String	Type of incomplete pass `Thrown Away`, `Pass Defended`, `Dropped Pass`, `Spike`, `Poorly Thrown`
`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
`knockdown`	`pass`	Integer	Number of knockdowns
`nullified`	`pass`	Boolean	Signifies a nullified play due to a penalty
`on_target_throw`	`pass`	Integer	Number of on target throws
`pocket_time`	`pass`	Double	Time spent in the pocket ex. `1.153`
`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
`downed`	`punt`	Integer	Number of downed punts
`endzone`	`punt`	Integer	Number of punts into the endzone
`faircatch`	`punt`	Integer	Number of fair catch punts
`hang_time`	`punt`	Double	Hang time of a punt in seconds ex.`3.166`
`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
`broken_tackles`	`receive`	Integer	Number of receiving broken tackles
`catchable`	`receive`	Integer	Number of receiving catchable passes
`dropped`	`receive`	Integer	Number of receiving drops
`firstdown`	`receive`	Integer	Number of receiving first downs
`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_contact`	`receive`	Integer	Number of receiving yards after contact

Return Play Statistics

Attribute	Parent Element	Type	Description
`category`	`return`	String	Type of return `punt_return`, `kick_return`
`downed`	`return`	Integer	Number of returns downed
`faircatch`	`return`	Integer	Number of return fair catches
`firstdown`	`return`	Integer	Number of return first downs
`lateral`	`return`	Integer	Number of return laterals
`nullified`	`return`	Boolean	Signifies a nullified play due to a penalty
`out_of_bounds`	`return`	Integer	Number of returns out of bounds
`play_category`	`return`	String	Type of return play `punt_return`, `kick_return`
`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
`broken_tackles`	`rush`	Integer	Number of rushing broken tackles
`firstdown`	`rush`	Integer	Number of rushing first downs
`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
`kneel_down`	`rush`	Integer	Number of rushing kneel downs
`lateral`	`rush`	Integer	Number of rushing laterals
`nullified`	`rush`	Boolean	Signifies a nullified play due to a penalty
`safety`	`rush`	Integer	Number of rushing safeties
`scramble`	`rush`	Integer	Number of rushing scrambles
`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
`yards_after_contact`	`rush`	Integer	Number of rushing yards after contact

Player

Attribute	Parent Element	Type	Description
`name`	`player`	String	Full name of a player ex. `George Kittle`
`id`	`player`	GUID	Unique ID of a player ex. `7e648a0b-fdc8-4661-a587-5826f2cac11b`
`jersey`	`player`	String	Jersey number of a player
`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`
`sr_id`	`player`	String	Unique Sportradar player ID ex. `sr:player:828235`

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. `MIN` (Minnesota)
`id`	`team`	GUID	Unique ID of a team ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`market`	`team`	String	Team market name ex. `Minnesota`
`name`	`team`	String	Team name ex. `Vikings`
`sr_id`	`team`	String	Unique Sportradar ID of a team ex. `sr:competitor:4324`

Venue

Attribute	Parent Element	Type	Description
`address`	`venue`	String	Address of a venue ex. `900 S 5th Street`
`capacity`	`venue`	Integer	Capacity of a venue ex. `72220`
`city`	`venue`	String	City of a venue ex. `Minneapolis`
`country`	`venue`	String	Country of a venue ex. `USA`
`id`	`venue`	GUID	Unique ID of a venue ex. `6a72e5ca-33d0-40af-8e6b-b32a4d3d9346`
`lat`	`venue`	Decimal	Latitude of a venue ex. `29.684735`
`lng`	`venue`	Decimal	Longitude of a venue ex. `-95.410725`
`name`	`venue`	String	Name of a venue ex. `U.S. Bank Stadium`
`roof_type`	`venue`	String	Roof type of a venue `outdoor`, `dome`, `retractable_dome`
`sr_id`	`venue`	String	Unique Sportradar venue ID ex. `sr:venue:2402`
`state`	`venue`	String	State of a venue ex. `MN`
`surface`	`venue`	String	Surface type of a venue `turf`, `artificial`
`zip`	`venue`	Integer	ZIP code of a venue ex. `77054`

200200