get https://api.sportradar.com/nfl/official//v7//games//boxscore.
NFL Game Boxscore provides game scoring information for each team, including complete play-by-play information for all scoring drives.
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 decisionkick , receive , defer |
direction | coin_toss - away | String | Away team coin toss direction chosenkick , receive |
outcome | coin_toss - away | String | Away team coin toss outcomewon , 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 decisiondefer , receive , defer |
direction | coin_toss - home | String | Home team coin toss direction chosenkick , receive |
outcome | coin_toss - home | String | Home team coin toss outcomewon , 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 playpass , 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 gameLDE (Live Data Entry) |
game_type | game | String | Type of gameregular , 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 conditions for a game ex. Partly cloudy |
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 seasonPRE , REG , PST |
type | season | String | Type of the seasonPRE , 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 penaltyaccepted , 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/challengeoverturned , 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 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 eventsetup , 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 |
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 whether the defense blitzed on 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 |
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 |
hash_mark | play | String | The hash mark of the ball at the beginning of a playRight Hash , Left Hash |
home_points | play | Integer | Home points at the end of a play |
huddle | play | String | Signifies whether there was a huddle prior to a play |
id | play | GUID | Unique ID of a play |
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 |
pass_route | play | String | Type of pass route on a passing play |
play_action | play | Boolean | Signifies whether there was a play action for a play |
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 playScramble 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 playShotgun , 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 whether a play is a run/pass option |
running_lane | play | Integer | Signifies which hole the running back ran through on a rush play (1-8) |
scoring_play | play | Boolean | Signifies whether a play resulted in a score |
screen_pass | play | Boolean | Signifies whether a play is a screen pass |
sequence | play | Decimal | Sequence number of an event or play. Used to sequence events properly ex. 1665336878436.0 |
type | play | String | Type of playpass , 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 attemptextra_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 kickfield_goal , extra_point , punt |
Conversion Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempt | conversion | Integer | Number of conversion attempts |
category | conversion | String | Category of conversionpass , 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 statisticdefense , 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 knowckdowns |
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 | Integer | 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 conversionconversion , 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 conversionconversion , extra_point |
down | down_conversion | Integer | Number of the down at play start |
category | first_down | String | Type of first downpass , 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 plays in a goal-to-go situation |
hurry | pass | Integer | Number of pass hurries |
incompletion_type | pass | String | Type of incomplete passThrown 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 |
out_of_bounds | punt | Integer | Number of punts out of bounds |
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 goal-to-go |
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 returnpunt_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 playpunt_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 goal-to-go |
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 |
Standings:
Attribute | Parent Element | Type | Description |
---|---|---|---|
losses | record | Integer | Number of team losses year-to-date before the game. Record is updated post-game based on the game outcome |
ties | record | Integer | Number of team ties year-to-date before the game. Record is updated post-game based on the game outcome |
wins | record | Integer | Number of team wins year-to-date before the game. Record is updated post-game based on the game outcome |
Team:
Attribute | Parent Element | Type | Description |
---|---|---|---|
alias | team | String | Team alias ex. 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 venueoutdoor , 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 venueturf , artificial |
zip | venue | Integer | ZIP code of a venue ex. 77054 |