Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Game Play-by-Play

NFL Game Play-by-Play provides a live play-by-play timeline, including possession and location information as well as all team and player statistics earned on each play.

⏱️

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:
AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game
decisionawayStringAway team coin toss decision
kick, receive, defer
directionawayStringAway team coin toss direction chosen
outcomeawayStringAway team coin toss outcome
won, lost
pointsawayIntegerAway team points in a quarter
remaining_challengesawayIntegerAway team challenges remaining
remaining_timeoutsawayIntegerAway team timeouts remaining
used_challengesawayIntegerAway team challenges used
used_timeoutsawayIntegerAway team timeouts used
pointsawayIntegerAway team total points
clockgameStringClock value of the game
quartercoin_tossStringCoin toss within a period. A coin toss will occur at the start of the game, half (period 3), and overtime
decisionhomeStringHome team coin toss decision
defer, receive, defer
directionhomeStringHome team coin toss direction chosen
outcomehomeStringHome team coin toss outcome
won, lost
pointshomeIntegerHome team points in a quarter
remaining_challengeshomeIntegerHome team challenges remaining
remaining_timeoutshomeIntegerHome team timeouts remaining
used_challengeshomeIntegerHome team challenges used
used_timeoutshomeIntegerHome team timeouts used
pointshomeIntegerHome team total points
idovertimeGUIDOvertime unique ID
numberovertimeIntegerOvertime number
sequenceovertimeIntegerPeriod sequence number (The first overtime sequence would be 5)
quartergameIntegerQuarter number of a game
idquarterGUIDQuarter unique ID
numberquarterIntegerQuarter number
sequencequarterIntegerPeriod sequence number
Game:

Attribute

Parent Element

Type

Description

alias

away

String

Away team alias

id

away

GUID

Away team unique ID

market

away

String

Away team market name
ex. Minnesota

name

away

String

Away team name

sr_id

away

String

Away team Sportradar ID

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

duration

game

String

Duration of the game

entry_mode

game

String

Type of data entry for the game

alias

home

String

Home team alias

id

home

GUID

Home team unique ID

market

home

String

Home team market name
ex. Green Bay

name

home

String

Home team name

sr_id

home

String

Home team Sportradar ID

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

Game scheduled start date/time

sr_id

game

String

Game Sportradar ID

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

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

String

Humidity conditions for the game

temp

weather

String

Temperature for the game

direction

wind

String

Wind direction for the game

speed

wind

String

Wind speed for the game

League:
AttributeParent ElementTypeDescription
idseasonGUIDUnique season ID
nameseasonStringName of the season
typeseasonStringType of the season
yearseasonIntegerYear of the season
idweekGUIDUnique week ID
sequenceweekIntegerWeek sequence number
titleweekStringWeek title
Play-by-Play Details:

Attribute

Parent Element

Type

Description

category

detail

String

Play detail category
ex. kick_off, kick_off_return, tackle

See our FAQ for all possible detail categories

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 a fumble, but before the ball was recovered

Will not appear for games with entry_mode="LDE"

no_attempt

detail

String

Indicates a player should receive a statistical attempt for a play. Generally used on laterals

Will not appear for games with entry_mode="LDE"

onside

detail

String

Indicates 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

Type of missed field goal attempt
Blocked, Hit Crossbar, Hit Left Upright, Hit Right Upright, Short, Wide Left, Wide Right

Will not appear for games with entry_mode="LDE"

result

detail

String

Result of the play

See here for a list of valid results

sack_split

detail

String

Signifies a sack was split between two defenders

Will not appear for games with entry_mode="LDE"

safety

detail

Boolean

Indicates 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 plyer 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:
AttributeParent ElementTypeDescription
clockend_situationStringGame clock value at the end of a play
downend_situationIntegerDown at the end of a play
aliaslocationStringTeam alias of the location of the ball at the end of a play
ex. MIN (Minnesota)
idlocationGUIDUnique team ID of the team with possession at the end of a play
marketlocationStringTeam market name
ex. Minnesota
namelocationStringTeam name
ex. Vikings
sr_idlocationGUIDUnique ID of a team
ex. sr:competitor:4423
yardlinelocationIntegerYardline of the ball at the end of a play
aliaspossessionStringTeam alias of the possession of the ball at the end of a play
ex. MIN (Minnesota)
idpossessionGUIDUnique team ID of the team with possession at the end of a play
marketpossessionStringTeam market name
ex. Minnesota
namepossessionStringTeam name
ex. Vikings
sr_idpossessionGUIDUnique ID of a team
ex. sr:competitor:4423
yfdend_situationIntegerYards to gain a first down at the end of a play
Play-by-Play Event:
AttributeParent ElementTypeDescription
clockeventStringClock value for an event
ex. 12:37
created_ateventDate/TimeTimestamp of the creation of an event
ex. 2022-09-20T00:54:16+00:00
description-StringText description of an event
ideventStringUnique ID of an event
sequenceeventDecimalSequence number of an event or play as a UNIX timestamp. Use this value to help sequence play-by-play events (smallest to largest sequence number).
ex. 1665336878436.0
typeeventStringType of an event
setup, timeout, tv_timeout, two_minute_warning, comment, period_end, game_over
updated_ateventDate/TimeTimestamp of the last update of an event
ex. 2022-09-20T00:54:16+00:00
wall_clockeventDate/TimeTimestamp 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:
AttributeParent ElementTypeDescription
idpoints-after-playGUIDUnique ID of a point after attempt
typepoints-after-playStringType of a point after attempt
extra_point, conversion, penalty
sequencepoints-after-playDecimalSequence number of a point after play as a UNIX timestamp. Use this value to help sequence play-by-play events (smallest to largest sequence number).
ex. 1665336878436.0
Play-by-Play Quarter:
AttributeParent ElementTypeDescription
idquarterGUIDUnique ID of a quarter
numberquarterIntegerNumber of a quarter
sequencequarterIntegerSequential number of a quarter
Play-by-Play Scoring:
AttributeParent ElementTypeDescription
away_pointsscoreIntegerNumber of away team points
clockscoreBooleanClock value for a score
ex. 12:37
home_pointsscoreIntegerNumber of home team points
pointsscoreIntegerNumber of points for a score
sequencescoreIntegerSequence number of an event or play. Used to sequence events properly
Play-by-Play Starting Situation:
AttributeParent ElementTypeDescription
clockstart_situationStringClock value at the start of a play
ex. 12:37
downstart_situationIntegerDown at the start of a play
aliaslocationStringTeam alias of the location of the ball at the start of a play
ex. MIN (Minnesota)
idlocationGUIDUnique team ID of the team with possession at the start of a play
marketlocationStringTeam market name
ex. Minnesota
namelocationStringTeam name
ex. Vikings
sr_idlocationGUIDUnique ID of a team
ex. sr:competitor:4423
yardlinelocationIntegerYardline of the ball at the start of a play
aliaspossessionStringTeam alias of the possession of the ball at the start of a play
ex. MIN (Minnesota)
idpossessionGUIDUnique team ID of the team with possession at the start of a play
marketpossessionStringTeam market name
ex. Minnesota
namepossessionStringTeam name
ex. Vikings
sr_idpossessionGUIDUnique ID of a team
ex. sr:competitor:4423
yfdend_situationIntegerYards to gain a first down at the start of a play
Kick & Punt Block Play Statistics:
AttributeParent ElementTypeDescription
blockblockIntegerNumber kick blocks
categoryblockStringType of blocked kick
field_goal, extra_point, punt
Conversion Play Statistics:
AttributeParent ElementTypeDescription
attemptconversionIntegerNumber of conversion attempts
categoryconversionStringCategory of conversion
pass, receive, rush, turnover
completeconversionIntegerNumber of conversion completions
safetyconversionIntegerNumber 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 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

Double

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:
AttributeParent ElementTypeDescription
attemptdefense_conversionIntegerNumber of defensive conversion attempts
categorydefense_conversionStringCategory of defensive conversion
conversion, extra_point
completedefense_conversionIntegerNumber of defensive conversion completions
Down Conversion Play Statistics:
AttributeParent ElementTypeDescription
attemptdown_conversionIntegerNumber of down conversion attempts
completedown_conversionStringCategory of down conversion
conversion, extra_point
downdown_conversionIntegerNumber of the down at play start
categoryfirst_downStringType of first down
pass, rush, penalty
Extra Point Play Statistics:
AttributeParent ElementTypeDescription
abortedextra_pointIntegerNumber of aborted extra points
attemptextra_pointIntegerNumber of attempted extra points
blockedextra_pointIntegerNumber of blocked extra points
madeextra_pointIntegerNumber of made extra points
missedextra_pointIntegerNumber of missed extra points
returnedextra_pointIntegerNumber of returned extra points
safetyextra_pointIntegerNumber of extra point safeties
Field Goal Play Statistics:
AttributeParent ElementTypeDescription
attemptfield_goalIntegerNumber of attempted field goals
att_yardsfield_goalIntegerYardage of attempted field goal
blockedfield_goalIntegerNumber of blocked field goals
madefield_goalIntegerNumber of made field goals
missedfield_goalIntegerNumber of missed field goals
nullifiedfield_goalBooleanSignifies a nullified field goal attempt
returnedfield_goalIntegerNumber of returned field goals
yardsfield_goalIntegerYardage of made field goal
Fumbles Play Statistics:
AttributeParent ElementTypeDescription
forcedfumbleIntegerNumber of forced fumbles
fumblefumbleIntegerNumber of fumbles
lostfumbleIntegerNumber of lost fumbles
nullifiedfumbleBooleanSignifies a nullified play due to a penalty
opp_recfumbleIntegerNumber of opponent fumble recoveries
opp_rec_tdfumbleIntegerNumber of opponent fumble recovery touchdowns
opp_rec_yardsfumbleIntegerNumber of opponent fumble recovery yards
out_of_boundsfumbleIntegerNumber of fumbles out of bounds
own_recfumbleIntegerNumber of own fumble recoveries
own_rec_tdfumbleIntegerNumber of own fumble recovery touchdowns
own_rec_yardsfumbleIntegerNumber of own fumble recovery yards
play_categoryfumbleStringType of fumble
ex. misc
Kickoff Play Statistics:
AttributeParent ElementTypeDescription
attemptkickIntegerNumber of kickoff attempts
endzonekickIntegerNumber of kicks into the endzone
inside_20kickIntegerNumber of kicks inside the 20 yardline
net_yardskickIntegerNumber of net yards on the kickoff
nullifiedkickBooleanSignifies a nullified play due to a penalty
onside_attemptkickBooleanNumber of onside kickoff attempts
onside_successkickBooleanNumber of onside kickoff successes
own_reckickBooleanNumber of own recoveries on a kickoff
own_rec_tdkickBooleanNumber of own recovery touchdowns on a kickoff
squib_kickkickBooleanNumber of squib kicks
touchbackkickBooleanNumber of touchbacks
yardskickBooleanNumber of kickoff yards
Passing Play Statistics:
AttributeParent ElementTypeDescription
attemptpassIntegerNumber of pass attempts
att_yardspassIntegerNumber of pass attempt (air) yards, measured from the line of scrimmage to the yardline of the receiving target
batted_passpassIntegerNumber of batted passes
blitzpassIntegerNumber of blitzes
completepassIntegerNumber of pass completions
firstdownpassIntegerNumber of passing first downs
goaltogopassIntegerNumber of pass plays in a goal-to-go situation (eg. 1st & Goal, 2nd & Goal, etc.)
hurrypassIntegerNumber of pass hurries
incompletion_typepassStringType of incomplete pass
Thrown Away, Pass Defended, Dropped Pass, Spike, Poorly Thrown
inside_20passIntegerNumber of passes inside the 20 yardline
interceptionpassIntegerNumber of interceptions thrown
int_touchdownpassIntegerNumber of interception touchdowns thrown
knockdownpassIntegerNumber of knockdowns
nullifiedpassBooleanSignifies a nullified play due to a penalty
on_target_throwpassIntegerNumber of on target throws
pocket_timepassDoubleTime spent in the pocket ex. 1.153
sackpassIntegerNumber of sacks
sack_yardspassDoubleNumber of sack yards
safetypassIntegerNumber of safeties
touchdownpassIntegerNumber of touchdowns
yardspassIntegerNumber of passing yards
Penalty Play Statistics:
AttributeParent ElementTypeDescription
penaltypenaltyIntegerNumber of penalties
yardspenaltyIntegerNumber of penalty yardage
Punting Play Statistics:
AttributeParent ElementTypeDescription
attemptpuntIntegerNumber of attempted punts
blockedpuntIntegerNumber of blocked punts
downedpuntIntegerNumber of downed punts
endzonepuntIntegerNumber of punts into the endzone
faircatchpuntIntegerNumber of fair catch punts
hang_timepuntDoubleHang time of a punt in seconds ex.3.166
inside_20puntIntegerNumber of punts inside the 20 yardline
net_yardspuntIntegerNet yardage of a punt
nullifiedpuntBooleanSignifies a nullified play due to a penalty
out_of_boundspuntIntegerNumber of punts out of bounds
touchbackpuntIntegerNumber of touchback punts
yardspuntIntegerYardage of punt
Receiving Play Statistics:
AttributeParent ElementTypeDescription
broken_tacklesreceiveIntegerNumber of receiving broken tackles
catchablereceiveIntegerNumber of receiving catchable passes
droppedreceiveIntegerNumber of receiving drops
firstdownreceiveIntegerNumber of receiving first downs
goaltogoreceiveIntegerNumber of receptions in goal-to-go (eg. 1st & Goal, 2nd & Goal, etc.)
inside_20receiveIntegerNumber of receptions inside the 20 yardline
nullifiedreceiveBooleanSignifies a nullified play due to a penalty
receptionreceiveIntegerNumber of receptions
safetyreceiveIntegerNumber of receiving safeties
targetsreceiveIntegerNumber of receiving targets
touchdownreceiveIntegerNumber of receiving touchdowns
yardsreceiveIntegerNumber of receiving yards
yards_after_catchreceiveIntegerNumber of receiving yards after the catch
yards_after_contactreceiveIntegerNumber of receiving yards after contact
Return Play Statistics:
AttributeParent ElementTypeDescription
categoryreturnStringType of return
punt_return, kick_return
downedreturnIntegerNumber of returns downed
faircatchreturnIntegerNumber of return fair catches
firstdownreturnIntegerNumber of return first downs
lateralreturnIntegerNumber of return laterals
nullifiedreturnBooleanSignifies a nullified play due to a penalty
out_of_boundsreturnIntegerNumber of returns out of bounds
play_categoryreturnStringType of return play
punt_return, kick_return
returnreturnIntegerNumber of returns
touchbackreturnIntegerNumber of return touchbacks
touchdownreturnIntegerNumber of return touchdowns
yardsreturnIntegerNumber of return yardage
Rushing Play Statistics:
AttributeParent ElementTypeDescription
attemptrushIntegerNumber of rushing attempts
broken_tacklesrushIntegerNumber of rushing broken tackles
firstdownrushIntegerNumber of rushing first downs
goaltogorushIntegerNumber of rushes in a goal-to-go situation (eg. 1st & Goal, 2nd & Goal, etc.)
inside_20rushIntegerNumber of rushes inside the 20 yardline
kneel_downrushIntegerNumber of rushing kneel downs
lateralrushIntegerNumber of rushing laterals
nullifiedrushBooleanSignifies a nullified play due to a penalty
safetyrushIntegerNumber of rushing safeties
scramblerushIntegerNumber of rushing scrambles
tlostrushIntegerNumber of rushing tackles for a loss
tlost_yardsrushIntegerNumber of rushing tackles for a loss yardage
touchdownrushIntegerNumber of rushing touchdowns
yardsrushIntegerNumber of rushing yards
yards_after_contactrushIntegerNumber of rushing yards after contact
Player:
AttributeParent ElementTypeDescription
nameplayerStringFull name of a player
ex. George Kittle
idplayerGUIDUnique ID of a player
ex. 7e648a0b-fdc8-4661-a587-5826f2cac11b
jerseyplayerStringJersey number of a player
positionplayerStringPosition of an NFL player
roleplayerStringRole of a player during a specific play
ex. pass, receive, tackle, rush, defend, catch, ast_tackle, kick, return, penalty
sr_idplayerStringPlayer Sportradar ID
ex. sr:player:828235
Standings:

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

AttributeParent ElementTypeDescription
lossesrecordIntegerNumber of team losses year-to-date after a game
tiesrecordIntegerNumber of team ties year-to-date after a game
winsrecordIntegerNumber of team wins year-to-date after a game
Team:
AttributeParent ElementTypeDescription
aliasteamStringTeam alias
ex. MIN (Minnesota)
idteamGUIDUnique team ID
ex. 82d2d380-3834-4938-835f-aec541e5ece7
marketteamStringTeam market name
ex. Minnesota
nameteamStringTeam name
ex. Vikings
sr_idteamStringTeam Sportradar ID
ex. sr:competitor:4324
Venue:
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue
capacityvenueIntegerCapacity of a venue
ex. 72220
cityvenueStringCity of a venue
countryvenueStringCountry of a venue
idvenueGUIDUnique ID of a venue
ex. 6a72e5ca-33d0-40af-8e6b-b32a4d3d9346
latvenueDecimalLatitude of a venue
ex. 29.684735
lngvenueDecimalLongitude of a venue
ex. -95.410725
namevenueStringName of a venue
roof_typevenueStringRoof type of a venue
outdoor, dome, retractable_dome
sr_idvenueStringVenue Sportradar ID
ex. sr:venue:2402
statevenueStringState of a venue
ex. MN
surfacevenueStringSurrace type of a venue
turf, artifical
zipvenueIntegerZIP code of a venue
ex. 77054
Language
Credentials
Header
Click Try It! to start a request and see the response here!