Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Push Events

UFL Push Events provides detailed, real-time information on every live game event.

Syntax

https://api.sportradar.com/ufl/{access_level}/stream/{language_code}/events/subscribe

Parameters

ParameterDescription
access_levelDefines the access level of your API key

production, trial
language_codeOptional code for supported languages

en (English)
🔐

Authorization

Place your API key in the header for each request (x-api-key)


Optional Query String Parameters

By default, a Push feed will provide all data available for all in progress games. If needed, you can filter the data returned by including query strings.

Each query string parameter can be added with a preceding ampersand (&).

ParameterDescription
event_categoryEvent category

redzone, two_minute, scoring_play, big_play, turnover

Example: event_category=redzone
event_typeEvent type

setup, timeout, tv_timeout, two_minute_warning, comment, period_end, game_over

Example: event_type=timeout
localeLanguage returned expressed as a 2-letter code

en (English)

Example: locale=en
matchMatch id

Example: match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d
teamTeam id

Example: team=sd:team:4415b0a7-0f24-11e2-8525-18a905767e44
statusGame status

inprogress, created

Example: status=inprogress


Code Samples

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/ufl/trial/stream/en/events/subscribe")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body
import requests
import json

headers = {
    'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get(
    "https://api.sportradar.com/ufl/trial/stream/en/events/subscribe",
    headers=headers,
    allow_redirects=False
)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True, headers=headers)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))
curl -L -X GET 'https://api.sportradar.com/ufl/trial/stream/en/events/subscribe' \
  -H 'x-api-key: {your_api_key}'

Samples with Query String Params

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.sportradar.com/ufl/trial/stream/en/events/subscribe?&status=inprogress&match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Get.new(url)
request["x-api-key"] = "{your_api_key}"  # Replace with your actual key

response = http.request(request)
puts response.read_body
import requests
import json

headers = {
    'x-api-key': 'your_api_key'  # Replace with your actual key
}

r = requests.get("https://api.sportradar.com/ufl/trial/stream/en/events/subscribe",
    params = {'status': 'inprogress', 'match': 'sd:match:673b459c-7506-4c11-9273-1b9502537f1d'},
    allow_redirects=False)

redirect_url = r.headers['Location']
r = requests.get(redirect_url, stream=True)

for line in r.iter_lines():
    # filter out keep-alive new lines
    if line:
        decoded_line = line.decode('utf-8')
        print(json.loads(decoded_line))
curl -L -X GET 'api.sportradar.com/ufl/trial/stream/en/events/subscribe?&status=inprogress&match=sd:match:673b459c-7506-4c11-9273-1b9502537f1d'
  -H 'x-api-key: {your_api_key}'


Sample Data

The above commands return json like this.


Simulations

Check out our Simulationsto replay actual games at any time, on your own schedule. Push simulations are available as well.



Data Points

Boxscore
AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game

ex. 73242
remaining_timeoutsawayIntegerAway team timeouts remaining
used_timeoutsawayIntegerAway team timeouts used
pointsawayIntegerAway team total points
pointshomeIntegerHome team total points
clockgameStringClock value of the game

ex. 12:37
remaining_timeoutshomeIntegerHome team timeouts remaining
used_timeoutshomeIntegerHome team timeouts used
quartergameIntegerQuarter number of the game
Game
AttributeParent ElementTypeDescription
aliasawayStringAway team alias

ex. MEM (Memphis)
idawayGUIDUnique ID of the away team

ex. 51da96b0-9676-11ec-9ad0-d3ebe46bbb12
marketawayStringAway team market name

ex. New Orleans
nameawayStringAway team name

ex. Breakers
sr_idawayStringUnique Sportradar ID of the away team

ex. sr:competitor:882413
durationgameStringDuration of the game

ex. 2:52
entry_modegameStringType of data entry for the game

LDE (Live Data Entry)
aliashomeStringHome team alias

ex. TB (Tampa Bay)
idhomeGUIDUnique ID of the home team

ex. 6b5d0b90-9676-11ec-9ad0-d3ebe46bbb12
markethomeStringHome team market name

ex. Tampa Bay
namehomeStringHome team name

ex. Bandits
sr_idhomeStringUnique Sportradar ID of the home team

ex. sr:competitor:882415
idgameGUIDUnique ID of a game

ex. 13025660-aa95-4885-b33e-3a3554d4c4c3
scheduledgameDate/TimeScheduled date and time of a game

ex. 2022-09-25T20:10:00+00:00
sr_idgameStringUnique Sportradar ID of a game

ex. sr:match:33623305
statusgameStringGame status

scheduled, created, inprogress, halftime, complete, closed, cancelled, delayed, suspended, postponed, time-tbd

See our UFL FAQ for game status descriptions
weathergameStringWeather description for a game

ex. Sunny Temp: 69 F, Humidity: 70%, Wind: WSW 9 mph
wx_conditiongameStringWeather condition for a game

ex. Partly cloudy, Clear, Light Rain, Mist

Click here for more info on weather condition values
wx_humiditygameByteHumidity conditions for a game

ex. 44
wx_tempgameByteTemperature of a game in Fahrenheit

ex. 57
wx_wind_directiongameStringWind direction for a game

ex. N
wx_wind_speedgameByteWind speed for a game in MPH
Metadata
AttributeParent ElementTypeDescription
event_categorymetadataStringCategory of an event

ex. scoring_play
event_typemetadataStringType of an event

ex. pass or field_goal
leaguemetadataStringAlias of a league

ex. ufl
localemetadataStringLanguage code

ex. en (English)
matchmetadataGUIDUnique ID(s) of a game

ex. sd:match:932eea38-0d94-4db5-b861-69b1a0ca47dc,sr:match:325678
operationmetadataStringOperation of an update

update, delete
statusmetadataStringThe status of a game

scheduled, created, inprogress, halftime, complete, closed, cancelled, postponed, delayed, flex-schedule, time-tbd
teammetadataGUIDUnique ID(s) of a team

ex. sd:team:c8797380-9677-11ec-9193-6b32ce92fd29,sr:competitor:882423
versionmetadataStringVersion of the API

ex. v6
Play-by-Play Details
AttributeParent ElementTypeDescription
categorydetailsStringPlay detail category

ex. kick_off, kick_off_return, tackle
description-StringText description of a play

ex. G.Groshek rushed to PIT 37 for 7 yards. Tackled by TB at PIT 37.
directiondetailsStringDirection 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
aliasend_locationStringTeam alias of the location of the ball at the conclusion of a play

ex. SA (Pittsburgh)
yardlineend_locationIntegerYardline location of the ball at the conclusion of a play

ex. 45
onsidedetailsStringSignifies an onside kick
descriptionpenaltyStringText description of a penalty

ex. ENALTY on TB-D.Mack, Defensive Holding, 5 yards, accepted.
no_playpenaltyStringSignifies a nullified play due to a penalty
resultpenaltyStringResult of a penalty

accepted, declined, offset
yardspenaltyIntegerNumber of yards penalized on the play
resultdetailsStringResult of the play
safetydetailsBooleanSignifies a play ending in a safety
sequencedetailsIntegerSequence number of the play detail
aliasstart_locationStringTeam alias of the location of the ball at the beginning of a play

ex. SA (Pittsburgh)
yardlinestart_locationIntegerYardline location of the ball at the beginning of a play

ex. 45
yardsdetailsIntegerYards gained or lost on the play
Play-by-Play Details - Review
AttributeParent ElementTypeDescription
resultdetail - reviewStringResult of a play review/challenge

overturned, upheld
reverseddetail - reviewBooleanSignifies the call on the field was reversed when true
typedetail - reviewStringType 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.
aliasdetail - review - teamStringAlias of a team initiating a review/challenge

ex. SA
iddetail - review - teamGUIDUnique ID of a team initiating a review/challenge

ex. c8797380-9677-11ec-9193-6b32ce92fd29
marketdetail - review - teamStringMarket name of a team initiating a review/challenge

ex. San Antonio
namedetail - review - teamStringName of a team initiating a review/challenge

ex. Brahmas
sr_iddetail - review - teamStringUnique Sportradar ID of a team initiating a review/challenge

ex. sr:competitor:882423
Play-by-Play Details - Recovery
AttributeParent ElementTypeDescription
typedetail - recoveryStringType of recovery

ball out of bounds, blocked kick recovery, dead ball declared, fumble recovery, interception, other team, other_team, same player, same team
aliasdetail - recovery - teamStringAlias of a team recovering the ball

ex. SA
iddetail - recovery - teamGUIDUnique ID of a team recovering the ball

ex. c8797380-9677-11ec-9193-6b32ce92fd29
marketdetail - recovery - teamStringMarket name of a team recovering the ball

ex. San Antonio
namedetail - recovery - teamStringName of a team recovering the ball

ex. Brahmas
sr_iddetail - recovery - teamStringUnique Sportradar ID of a team recovering the ball

ex. sr:competitor:882423
Play-by-Play Drive
AttributeParent ElementTypeDescription
created_atdriveDate/TimeTimestamp of the start of a drive

ex. 2023-04-17T00:19:40+00:00
durationdriveStringDuration of a drive in MM:SS format

ex. 5:43
end_clockdriveStringGame clock value at the end of a drive

ex. 9:56
end_reasondriveStringEnd result of a drive

ex. Touchdown

See our FAQ for a list of valid end reasons and their definitions
farthest_drive_yardlinedriveIntegerThe furthest yardline the offensive team reached during a drive (1-99 scale)
first_downsdriveIntegerNumber of first downs in a drive
first_drive_yardlinedriveIntegerStarting yardline of the first play of a drive (1-99 scale)
gaindriveIntegerNumber of yards gained in a drive
iddriveGUIDUnique ID of a drive

ex. 1d491536-8263-4f48-9368-0d2e831f6840
inside_20driveBooleanSignifies a drive which ends inside the opponent's 20 yardline
last_drive_yardlinedriveIntegerStarting yardline of the last play of a drive (1-99 scale)
net_yardsdriveIntegerNet yards for the offensive team on a drive (Yards gained minus penalty yards)
pat_points_attempteddriveIntegerNumber of point after touchdown attempts on a drive
pat_successfuldriveBooleanSignifies a successful point after touchdown on a drive
penalty_yardsdriveIntegerNumber of penalty yards on a drive
play_countdriveIntegerNumber of plays in a drive
scoring_drivedriveBooleanSignifies a drive which ends in a score
sequencedriveIntegerSequential number of the drive within a game
start_clockdriveStringGame clock value at the start of a drive

ex. 4:32
start_reasondriveStringStart reason of a drive

ex. Field Goal

See our FAQ for a list of valid start reasons and their definitions
team_sequencedriveIntegerSequential number of the drive for the offensive team
updated_atdriveDate/TimeTimestamp of the last update of a drive
iddrive - defensive_teamGUIDUnique ID of the defensive team for a drive

ex. 1d491536-8263-4f48-9368-0d2e831f6840
pointsdrive - defensive_teamIntegerNumber of points scored for the defensive team for a drive
iddrive - offensive_teamGUIDUnique ID of the offensive team for a drive

ex. 1d491536-8263-4f48-9368-0d2e831f6840
pointsdrive - offensive_teamIntegerNumber 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

ex. 14:55
downend_situationIntegerDown at the end of a play
aliasend_situation - locationStringTeam alias of the location of the ball at the end of a play

ex. SA (Pittsburgh)
idend_situation - locationGUIDUnique ID of a team of the team with possession at the end of a play

ex. 7b112545-38e6-483c-a55c-96cf6ee49cb8
marketend_situation - locationStringTeam market name

ex. San Antonio
nameend_situation - locationStringTeam name

ex. Brahmas
sr_idend_situation - locationGUIDUnique Sportradar ID of the team with possession at the end of a play

ex. sr:competitor:882423
yardlineend_situation - locationIntegerYardline of the ball at the end of a play
aliasend_situation - possessionStringTeam alias of the possession of the ball at the end of a play

ex. SA (Pittsburgh)
idend_situation - possessionGUIDUnique ID of a team of the team with possession at the end of a play

ex. 7b112545-38e6-483c-a55c-96cf6ee49cb8
marketend_situation - possessionStringTeam market name

ex. San Antonio
nameend_situation - possessionStringTeam name

ex. Brahmas
sr_idend_situation - possessionGUIDUnique Sportradar ID of the team with possession at the end of a play

ex. sr:competitor:882423
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

ex. G.Groshek rushed right guard to PIT 36 for 7 yards. Tackled by TB at PIT 36.
ideventStringUnique ID of an event

ex. fd790d30-4e81-11ed-b357-5954f3d7fdac
sequenceeventDecimalSequence number of an event or play. Used to sequence events properly

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
idevent - periodGUIDUnique ID of a period (quarter)

ex. 549d0bdb-da2a-4838-baec-12cec6691cf8
numberevent - periodIntegerNumber of a period (quarter)
sequenceevent - periodIntegerSequential number of a period (quarter)
Play-by-Play - Play
AttributeParent ElementTypeDescription
away_pointsplayIntegerAway points at the end of a play
clockplayStringClock value for a play

ex. 12:37
created_atplayDate/TimeTimestamp of the creation of a play

ex. 2022-09-20T00:54:16+00:00
description-StringText description of a play

ex. M.Coghlin punts 21 yards to PIT 18, Center-T.Bernard. I.Hennie returned punt from the PIT 18. I.Hennie for 82 yards, TOUCHDOWN.
home_pointsplayIntegerHome points at the end of a play
officialplayBooleanSignifies 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.
idplayGUIDUnique ID of a play

ex. fd8026f0-dcbc-11ed-b2c7-9159d1dff79a
play_directionplayStringDirection 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
scoring_playplayBooleanSignifies a play resulted in a score when true
sequenceplayDecimalSequence number of an event or play. Used to sequence events properly

ex. 1665336878436.0
typeplayStringType of play

pass, rush, faircatch_kick, extra_point, conversion, free_kick, kickoff, punt, field_goal, penalty
updated_atplayDate/TimeTimestamp of the last update of a play

ex. 2022-09-20T00:54:16+00:00
wall_clockplayDate/TimeTimestamp 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

ex. a397a7c0-47f8-11ed-972d-8539f16b8bbf
typepoints-after-playStringType of a point after attempt

extra_point, conversion, penalty
sequencepoints-after-playDecimalSequence number of an event or play. Used to sequence events properly

ex. 1665336878436.0
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

ex. 1665336878436.0
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. SA (Pittsburgh)
idstart_situation - locationGUIDUnique ID of a team of the team with possession at the start of a play

ex. 33405046-04ee-4058-a950-d606f8c30852
marketstart_situation - locationStringTeam market name

ex. San Antonio
namestart_situation - locationStringTeam name

ex. Brahmas
sr_idstart_situation - locationGUIDUnique Sportradar ID of the team with possession at the start of a play

ex. sr:competitor:882423
yardlinestart_situation - locationIntegerYardline of the ball at the start of a play
aliasstart_situation - possessionStringTeam alias of the possession of the ball at the start of a play

ex. SA (Pittsburgh)
idstart_situation - possessionGUIDUnique ID of a team of the team with possession at the start of a play

ex. 33405046-04ee-4058-a950-d606f8c30852
marketstart_situation - possessionStringTeam market name

ex. San Antonio
namestart_situation - possessionStringTeam name

ex. Brahmas
sr_idstart_situation - possessionGUIDUnique Sportradar ID of the team with possession at the start of a play

ex. sr:competitor:882423
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
AttributeParent ElementTypeDescription
ast_sackdefenseIntegerNumber of assisted sacks
ast_tackledefenseIntegerNumber of assisted tackles
ast_tlostdefenseIntegerNumber of assisted tackles for a loss
blockdefenseIntegerNumber of blocked kicks/punts
categorydefenseStringCategory of defensive statistic

defense, special_team, misc
forced_fumbledefenseIntegerNumber of forced fumbles
interceptiondefenseIntegerNumber of interceptions
int_touchdowndefenseIntegerNumber of interceptions for a touchdown
int_yardsdefenseIntegerNumber of interception yards
nullifieddefenseBooleanNullified play flag
pass_defendeddefenseIntegerNumber of passes defended
primarydefenseIntegerIndicates whether the assist tackler was the primary tackler on a play

*This stat is unsupported since 2021
qb_hitdefenseIntegerNumber of hits on the quarterback
sackdefenseIntegerNumber of sacks
sack_yardsdefenseDoubleNumber of sack yards
safetydefenseIntegerNumber of safeties
tlostdefenseIntegerNumber of tackles for a loss
tlost_yardsdefenseIntegerNumber of tackles for a loss yardage
tackledefenseIntegerNumber 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
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
endzonekickIntegerNumber of kickoffs into the endzone
inside_20kickIntegerNumber of kickoffs inside the 20 yardline
net_yardskickIntegerNumber of net yards on the kickoff
nullifiedkickBooleanSignifies a nullified play due to a penalty
onside_attemptkickIntegerNumber of onside kickoff attempts
onside_successkickIntegerNumber of onside kickoff successes
own_reckickIntegerNumber of own recoveries on a kickoff
own_rec_tdkickIntegerNumber of own recovery touchdowns on a kickoff
touchbackkickIntegerNumber of touchbacks
yardskickIntegerNumber 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
completepassIntegerNumber of pass completions
firstdownpassIntegerNumber of passing first downs
goaltogopassIntegerNumber of plays in a goal-to-go situation (eg. 1st & Goal, 2nd & Goal, etc.)
inside_20passIntegerNumber of passes inside the 20 yardline
interceptionpassIntegerNumber of interceptions thrown
int_touchdownpassIntegerNumber of interception touchdowns thrown
nullifiedpassBooleanSignifies a nullified play due to a penalty
sackpassIntegerNumber of sacks
sack_yardspassDoubleNumber of sack yards
safetypassIntegerNumber of safeties
touchdownpassIntegerNumber of passing 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
inside_20puntIntegerNumber of punts inside the 20 yardline
net_yardspuntIntegerNet yardage of a punt
nullifiedpuntBooleanSignifies a nullified play due to a penalty
touchbackpuntIntegerNumber of touchback punts
yardspuntIntegerYardage of punt
Receiving Play Statistics
AttributeParent ElementTypeDescription
firstdownreceiveIntegerNumber of receiving first downs
goaltogoreceiveIntegerNumber of receptions in a goal-to-go situation (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
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
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
lateralrushIntegerNumber of rushing laterals
nullifiedrushBooleanSignifies a nullified play due to a penalty
safetyrushIntegerNumber of rushing safeties
tlostrushIntegerNumber of rushing tackles for a loss
tlost_yardsrushIntegerNumber of rushing tackles for a loss yardage
touchdownrushIntegerNumber of rushing touchdowns
yardsrushIntegerNumber of rushing yards
Player
AttributeParent ElementTypeDescription
nameplayerStringFull name of a player

ex. Deon Cain
idplayerGUIDUnique ID of a player

ex. f99a57a0-bdb7-11ed-a9cf-659b88c64826
jerseyplayerIntegerJersey number of a player
positionplayerStringPosition of a player

See our FAQ for a list of valid positions
Team
AttributeParent ElementTypeDescription
aliasteamStringTeam alias

ex. SA
idteamGUIDUnique ID of a team

ex. c8797380-9677-11ec-9193-6b32ce92fd29
marketteamStringTeam market name

ex. San Antonio
nameteamStringTeam name

ex. Brahmas
sr_idteamStringUnique Sportradar ID of a team

ex. sr:competitor:882423