Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Push Statistics

UFL Push Statistics provides detailed, real-time game stats at the team and player level for all live games.

Syntax

https://api.sportradar.com/usfl/{access_level}/stream/{language_code}/statistics/subscribe

Parameters

Parameter

Description

access_level

Defines the access level of your API key

production, trial

language_code

Optional 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 (&).

Parameter

Description

event_category

Event category

redzone, two_minute, scoring_play, big_play, turnover

Example: event_category=redzone

event_type

Event type

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

Example: event_type=timeout

locale

Language returned expressed as a 2-letter code

en (English)

Example: locale=en

match

Match id

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

team

Team id

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

status

Game 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/statistics/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/statistics/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/statistics/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/statistics/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/statistics/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/statistics/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
attendancepayloadIntegerAttendance of a game
ex. 73242
remaining_challengesawayIntegerAway team challenges remaining
remaining_timeoutsawayIntegerAway team timeouts remaining
used_challengesawayIntegerAway team challenges used
used_timeoutsawayIntegerAway team timeouts used
pointsawayIntegerAway team total points
clockpayloadStringClock value of the game
ex. 12:37
remaining_challengeshomeIntegerHome team challenges remaining
remaining_timeoutshomeIntegerHome team timeouts remaining
used_challengeshomeIntegerHome team challenges used
used_timeoutshomeIntegerHome team timeouts used
pointshomeIntegerHome team total points
quarterpayloadIntegerQuarter number of the game
Game:

Attribute

Parent Element

Type

Description

alias

away

String

Away team alias
ex. MEM (Memphis)

id

away

GUID

Unique ID of the away team
ex. 51da96b0-9676-11ec-9ad0-d3ebe46bbb12

market

away

String

Away team market name
ex. New Orleans

name

away

String

Away team name
ex. Breakers

sr_id

away

String

Unique Sportradar ID of the away team
ex. sr:competitor:882413

conference_game

payload

Boolean

Signifies an in-Conference matchup

coverage

payload

String

Optional value that displays the coverage of a game
ex. full

duration

payload

String

Duration of the game
ex. 2:52

entry_mode

payload

String

Type of data entry for the game
LDE (Live Data Entry)

game_type

payload

String

Type of game
regular, playoff

alias

home

String

Home team alias
ex. SA

id

home

GUID

Unique ID of the home team
ex. c8797380-9677-11ec-9193-6b32ce92fd29

market

home

String

Home team market name
ex. San Antonio

name

home

String

Home team name
ex. Brahmas

sr_id

home

String

Unique Sportradar ID of the home team
ex. sr:competitor:882423

id

payload

GUID

Unique ID of a game
ex. 03aa477c-de6a-4d7a-90f4-97eed05f2e89

neutral_site

payload

Boolean

Signifies a game is held at a neutral site

scheduled

payload

Date/Time

Scheduled date and time of a game
ex. 2022-09-25T20:10:00+00:00

sr_id

payload

String

Unique Sportradar ID of a game
ex. sr:match:33623305

status

payload

String

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

See our UFL FAQ for game status descriptions

title

payload

String

Game title
ex. UFL Championship

wx_condition

payload

String

Weather condition for a game
ex. Partly cloudy, Clear, Light Rain, Mist

Click here for more info on weather condition values

wx_humidity

payload

Byte

Humidity conditions for a game
ex. 44

wx_temp

payload

Byte

Temperature of a game in Fahrenheit
ex. 57

wx_wind_direction

payload

String

Wind direction for a game
ex. N

wx_wind_speed

payload

Byte

Wind speed for a game in MPH

Game Statistics - Conversions (Player):
AttributeParent ElementTypeDescription
attemptsconversionsIntegerNumber of two-point conversion attempts
categoryconversionsStringCategory of conversion
pass, receive, rush, turnover
successesconversionsIntegerNumber of successful two-point conversions
Game Statistics - Defense (Player):

Attribute

Parent Element

Type

Description

assists

defense

Integer

Number of defensive assisted tackles

*Does not include misc. or special teams tackles

combined

defense

Integer

Number of combined (assists + tackles) defensive tackles

*Does not include misc. or special teams tackles

forced_fumbles

defense

Integer

Number of forced fumbles

fumble_recoveries

defense

Integer

Number of fumble recoveries

interceptions

defense

Integer

Number of interceptions

knockdowns

defense

Integer

Number of knockdowns

misc_assists

defense

Integer

Number of miscellaneous assisted tackles.
Ex: An assisted tackle by an offensive player on a defensive interception or fumble return

misc_forced_fumbles

defense

Integer

Number of miscellaneous forced fumbles.
Ex: A forced fumble by an offensive player on a defensive interception or fumble return

misc_fumble_recoveries

defense

Integer

Number of miscellaneous fumble recoveries.
Ex: A fumble recovery by an offensive player on a defensive interception or fumble return

misc_tackles

defense

Integer

Number of miscellaneous tackles.
Ex: A solo tackle by an offensive player on a defensive interception or fumble return

passes_defended

defense

Integer

Number of passes defended

qb_hits

defense

Integer

Number of hits on the quarterback

sack_yards

defense

Decimal

Number of sack yards

sacks

defense

Decimal

Number of sacks

safeties

defense

Integer

Number of safeties

sp_assists

defense

Integer

Number of special teams assisted tackles

sp_blocks

defense

Integer

Number of blocked kicks/punts

sp_forced_fumbles

defense

Integer

Number of special teams forced fumbles

sp_fumble_recoveries

defense

Integer

Number of special teams fumble recoveries

sp_tackles

defense

Integer

Number of special teams tackles

tackles

defense

Integer

Number of defensive tackles

*Does not include misc. or special teams tackles

tloss

defense

Decimal

Number of tackles for a loss

tloss_yards

defense

Decimal

Number of tackles for a loss yardage

Game Statistics - Extra Points (Player):
AttributeParent ElementTypeDescription
attemptsextra_pointsIntegerNumber of attempted extra points
blockedextra_pointsIntegerNumber of blocked extra points
madeextra_pointsIntegerNumber of made extra points
missedextra_pointsIntegerNumber of missed extra points
pctextra_pointsDecimalExtra point percentage
ex. 75.0
Game Statistics - Field Goals (Player):
AttributeParent ElementTypeDescription
attemptsfield_goalsIntegerNumber of attempted field goals
attempts_19field_goalsIntegerNumber of attempted field goals between 1-19 yards
attempts_29field_goalsIntegerNumber of attempted field goals between 20-29 yards
attempts_39field_goalsIntegerNumber of attempted field goals between 30-39 yards
attempts_49field_goalsIntegerNumber of attempted field goals between 40-49 yards
attempts_50field_goalsIntegerNumber of attempted field goals of 50 yards or more
avg_yardsfield_goalsDecimalAverage number of yards on attempted field goals
ex. 38.5
blockedfield_goalsIntegerNumber of blocked field goals
longestfield_goalsIntegerNumber of yards of longest made field goal
madefield_goals - playerIntegerNumber of made field goals
made_19field_goalsIntegerNumber of successful field goals between 1-19 yards
made_29field_goalsIntegerNumber of successful field goals between 20-29 yards
made_39field_goalsIntegerNumber of successful field goals between 30-39 yards
made_49field_goalsIntegerNumber of successful field goals between 40-49 yards
made_50field_goalsIntegerNumber of successful field goals of 50 yards or more
missedfield_goalsIntegerNumber of missed field goals
pctfield_goalsDecimalField goal percentage
ex. 75.0
yardsfield_goalsIntegerNumber of total yards on successful field goals
Game Statistics - Fumbles (Player):
AttributeParent ElementTypeDescription
ez_rec_tdsfumblesIntegerNumber of end zone fumble recovery touchdowns
forced_fumblesfumblesIntegerNumber of forced fumbles
fumblesfumblesIntegerNumber of fumbles
lost_fumblesfumblesIntegerNumber of lost fumbles
opp_recfumblesIntegerNumber of opponent fumble recoveries
opp_rec_tdsfumblesIntegerNumber of opponent fumble recovery touchdowns
opp_rec_yardsfumblesIntegerNumber of opponent fumble recovery yards
out_of_boundsfumblesIntegerNumber of opponent fumbles out of bounds
own_recfumblesIntegerNumber of own fumble recoveries
own_rec_tdsfumblesIntegerNumber of own fumble recovery touchdowns
own_rec_yardsfumblesIntegerNumber of own fumble recovery yards
Game Statistics - Interception Returns (Player):
AttributeParent ElementTypeDescription
avg_yardsint_returnsDecimalAverage number of yards on interception returns
ex. 38.5
longestint_returnsIntegerNumber of yards of longest interception return
longest_touchdownint_returnsIntegerNumber of yards of longest interception return for a touchdown
returnsint_returnsIntegerNumber of interception returns
touchdownsint_returnIntegerNumber of interception return touchdowns
yardsint_returnsIntegerNumber of total interception return yards
Game Statistics - Kick Returns (Player):
AttributeParent ElementTypeDescription
avg_yardskick_returnsDecimalAverage number of yards on kick returns
ex. 19.5
faircatcheskick_returnsIntegerNumber of fair catches on kick returns
longestkick_returnsIntegerNumber of yards of longest kick return
longest_touchdownkick_returnsIntegerNumber of yards of longest kick return for a touchdown
returnskick_returnsIntegerNumber of kick returns
touchdownskick_returnsIntegerNumber of kick return touchdowns
yardskick_returnsIntegerNumber of total kick return yards
Game Statistics - Kickoffs (Player):
AttributeParent ElementTypeDescription
endzonekickoffsIntegerNumber of kickoffs into the endzone
inside_20kickoffsIntegerNumber of kickoffs inside the 20 yardline
kickoffskickoffsIntegerNumber of kickoffs
onside_attemptskickoffsIntegerNumber of onside kickoff attempts
onside_successeskickoffsIntegerNumber of onside kickoff successes
out_of_boundskickoffsIntegerNumber of kickoffs out of bounds
return_yardskickoffsIntegerNumber of total return yards on kickoffs
total_endzonekickoffsIntegerNumber of total kickoffs into the endzone (touchbacks + endzone kicks)
touchbackskickoffsIntegerNumber of touchbacks
yardskickoffsIntegerNumber of kickoff yards
Game Statistics - Passing (Player):
AttributeParent ElementTypeDescription
air_yardspassingIntegerNumber of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point)
attemptspassingIntegerNumber of pass attempts
avg_yardspassingDecimalAverage yards per pass attempt
ex. 7.22
cmp_pctpassingDecimalCompletion percentage
ex. 78.049
completionspassingIntegerNumber of pass completions
first_downspassingIntegerNumber of first downs
interceptionspassingIntegerNumber of interceptions thrown
int_touchdownspassingIntegerNumber of interceptions thrown returned for touchdowns
longestpassingIntegerNumber of yards of longest completed pass
longest_touchdownpassingIntegerNumber of yards of longest pass for a touchdown
ratingpassingDecimalPasser rating
ex. 94.7
redzone_attemptspassingIntegerNumber of pass attempts in the red zone
sack_yardspassingIntegerNumber of sack yards
sackspassingIntegerNumber of sacks
touchdownspassingIntegerNumber of passing touchdowns
yardspassingIntegerNumber of passing yards
Game Statistics - Penalties (Player):
AttributeParent ElementTypeDescription
first_downspenaltiesIntegerNumber of penalties resulting in a first down
penaltiespenaltiesIntegerNumber of penalties
yardspenaltiesIntegerNumber of penalty yardage
Game Statistics - Punt Returns (Player):
AttributeParent ElementTypeDescription
avg_yardspunt_returnsDecimalAverage number of yards on punt returns
ex. 19.5
faircatchespunt_returnsIntegerNumber of fair catches on punt returns
longestpunt_returnsIntegerNumber of yards of longest punt return
longest_touchdownpunt_returnsIntegerNumber of yards of longest punt return for a touchdown
returnspunt_returnsIntegerNumber of punt returns
touchdownspunt_returnsIntegerNumber of punt return touchdowns
yardspunt_returnsIntegerNumber of total punt return yards
Game Statistics - Punts (Player):
AttributeParent ElementTypeDescription
attemptspuntsIntegerNumber of punt attempts
avg_net_yardspuntsDecimalAverage net yards on punts
ex. 28.75
avg_yardspuntsDecimalAverage yards on punts
ex. 43.75
blockedpuntsIntegerNumber of punts blocked
inside_20puntsIntegerNumber of punts inside the 20 yardline
longestpuntsIntegerNumber of yards of longest punt
net_yardspuntsIntegerNumber of total net punt yards
return_yardspuntsIntegerNumber of total return punt yards
out_of_boundspuntsIntegerNumber of punts out of bounds
return_yardspuntsIntegerNumber of total return yards on punts
touchbackspuntsIntegerNumber of touchbacks
yardspuntsIntegerNumber of punt yards
Game Statistics - Receiving (Player):
AttributeParent ElementTypeDescription
air_yardsreceivingIntegerNumber of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point)
avg_yardsreceivingDecimalAverage yards per reception
ex. 7.22
first_downsreceivingIntegerNumber of receiving first downs
longestreceivingIntegerNumber of yards of longest reception
longest_touchdownreceivingIntegerNumber of yards of longest receiving touchdown
receptionsreceivingIntegerNumber of receptions
redzone_targetsreceivingIntegerNumber of receiving red zone targets
targetsreceivingIntegerNumber of receiving targets
touchdownsreceivingIntegerNumber of receiving touchdowns
yardsreceivingIntegerNumber of receiving yards
yards_after_catchreceivingIntegerNumber of receiving yards after the catch
Game Statistics - Rushing (Player):
AttributeParent ElementTypeDescription
attemptsrushingIntegerNumber of rushing attempts
avg_yardsrushingDecimalAverage yards per rush
ex. 3.22
first_downsrushingIntegerNumber of rushing first downs
longestrushingIntegerNumber of yards of longest rush
longest_touchdownrushingIntegerNumber of yards of longest rushing touchdown
redzone_attemptsrushingIntegerNumber of rushing red zone attempts
lateralrushingIntegerNumber of rushing laterals
tlostrushingIntegerNumber of rushing tackles for a loss
tlost_yardsrushingIntegerNumber of rushing tackles for a loss yardage
touchdownsrushingIntegerNumber of rushing touchdowns
yardsrushingIntegerNumber of rushing yards
Game Statistics - Special Conversions (Player):
AttributeParent ElementTypeDescription
attemptsspecial_conversionsIntegerNumber of special conversion attempts
successesspecial_conversionsIntegerNumber of successful special conversions
pointsspecial_conversionsIntegerNumber of points for a successful conversions
categoryspecial_conversionsStringType of special conversion attempt
pass, receive, rush, defense
Game Statistics - Conversions (Team):
AttributeParent ElementTypeDescription
def_conv_attemptsextra_pointsIntegerNumber of defensive two-point conversion attempts
def_conv_successesextra_pointsIntegerNumber of successful defensive two-point conversions
pass_conv_attemptsextra_pointsIntegerNumber of two-point conversion passing attempts
pass_conv_successesextra_pointsIntegerNumber of successful passing two-point conversions
rush_conv_attemptsextra_pointsIntegerNumber of two-point conversion rushing attempts
rush_conv_successesextra_pointsIntegerNumber of successful rushing two-point conversions
Game Statistics - Defense (Team):

Attribute

Parent Element

Type

Description

assists

defense

Integer

Number of defensive assisted tackles

*Does not include misc. or special teams tackles

combined

defense

Integer

Number of combined (assists + tackles) defensive tackles

*Does not include misc. or special teams tackles

forced_fumbles

defense

Integer

Number of forced fumbles

fourth_down_stops

defense

Integer

Number of fourth down stops

fumble_recoveries

defense

Integer

Number of fumble recoveries

interceptions

defense

Integer

Number of interceptions

misc_assists

defense

Integer

Number of miscellaneous assisted tackles.

Ex: An assisted tackle by an offensive player on a defensive interception or fumble return

misc_forced_fumbles

defense

Integer

Number of miscellaneous forced fumbles.

Ex: A forced fumble by an offensive player on a defensive interception or fumble return

misc_fumble_recoveries

defense

Integer

Number of miscellaneous fumble recoveries.

Ex: A fumble recovery by an offensive player on a defensive interception or fumble return

misc_tackles

defense

Integer

Number of miscellaneous tackles.

Ex: A solo tackle by an offensive player on a defensive interception or fumble return

missed_tackles

defense

Integer

Number of missed tackles

passes_defended

defense

Integer

Number of passes defended

qb_hits

defense

Integer

Number of hits on the quarterback

sack_yards

defense

Decimal

Number of sack yards

sacks

defense

Decimal

Number of sacks

safeties

defense

Integer

Number of safeties

sp_assists

defense

Integer

Number of special teams assisted tackles

sp_blocks

defense

Integer

Number of blocked kicks/punts

sp_forced_fumbles

defense

Integer

Number of special teams forced fumbles

sp_fumble_recoveries

defense

Integer

Number of special teams fumble recoveries

sp_tackles

defense

Integer

Number of special teams tackles

tackles

defense

Integer

Number of defensive tackles

*Does not include misc. or special teams tackles

three_and_outs_forced

defense

Integer

Number of three and outs forced

tloss

defense

Decimal

Number of tackles for a loss

tloss_yards

defense

Decimal

Number of tackles for a loss yardage

Game Statistics - Efficiency (Team):
AttributeParent ElementTypeDescription
attemptsefficiency - thirddownIntegerNumber of third down attempts
successesefficiency - thirddownIntegerNumber of third down successes
pctefficiency - thirddownDecimalThird down conversion percentage
ex. 61.538
attemptsefficiency - fourthdownIntegerNumber of fourth down attempts
successesefficiency - fourthdownIntegerNumber of fourth down successes
pctefficiency - fourthdownDecimalFourth down conversion percentage
ex. 50.0
attemptsefficiency - goaltogoIntegerNumber of goal-to-go attempts (eg. 1st & Goal, 2nd & Goal, etc.)
successesefficiency - goaltogoIntegerNumber of goal-to-go successes (eg. 1st & Goal, 2nd & Goal, etc.)
pctefficiency - goaltogoDecimalGoal-to-go conversion percentage (eg. 1st & Goal, 2nd & Goal, etc.)
ex. 100.0
attemptsefficiency - onside_scrimmageIntegerNumber of onside scrimmage attempts
successesefficiency - onside_scrimmageIntegerNumber of onside scrimmage successes
pctefficiency - onside_scrimmageDecimalOnside scrimmage conversion percentage
ex. 50.0
attemptsefficiency - redzoneIntegerNumber of red zone attempts
successesefficiency - redzoneIntegerNumber of red zone successes
pctefficiency - redzoneDecimalRed zone conversion percentage
ex. 80.0
Game Statistics - Extra Points (Team):
AttributeParent ElementTypeDescription
kick_attemptsextra_pointsIntegerNumber of attempted extra points
kick_blockedextra_pointsIntegerNumber of blocked extra points
kick_madeextra_pointsIntegerNumber of made extra points
missedextra_pointsIntegerNumber of missed extra points
Game Statistics - Field Goals (Team):
AttributeParent ElementTypeDescription
attemptsfield_goalsIntegerNumber of attempted field goals
attempts_19field_goalsIntegerNumber of attempted field goals between 1-19 yards
attempts_29field_goalsIntegerNumber of attempted field goals between 20-29 yards
attempts_39field_goalsIntegerNumber of attempted field goals between 30-39 yards
attempts_49field_goalsIntegerNumber of attempted field goals between 40-49 yards
attempts_50field_goalsIntegerNumber of attempted field goals of 50 yards or more
avg_yardsfield_goalsDecimalAverage number of yards on attempted field goals
ex. 38.5
blockedfield_goalsIntegerNumber of blocked field goals
longestfield_goalsIntegerNumber of yards of longest made field goal
madefield_goalsIntegerNumber of made field goals
made_19field_goalsIntegerNumber of successful field goals between 1-19 yards
made_29field_goalsIntegerNumber of successful field goals between 20-29 yards
made_39field_goalsIntegerNumber of successful field goals between 30-39 yards
made_49field_goalsIntegerNumber of successful field goals between 40-49 yards
made_50field_goalsIntegerNumber of successful field goals of 50 yards or more
missedfield_goalsIntegerNumber of missed field goals
yardsfield_goalsIntegerNumber of total yards on successful field goals
Game Statistics - First Downs (Team):
AttributeParent ElementTypeDescription
passfirst_downsIntegerNumber of passing first downs
penaltyfirst_downsIntegerNumber of first downs due to penalty
rushfirst_downsIntegerNumber of rushing first downs
totalfirst_downsIntegerNumber of total first downs
Game Statistics - Fumbles (Team):
AttributeParent ElementTypeDescription
ez_rec_tdsfumblesIntegerNumber of end zone fumble recovery touchdowns
forced_fumblesfumblesIntegerNumber of forced fumbles
fumblesfumblesIntegerNumber of fumbles
lost_fumblesfumblesIntegerNumber of lost fumbles
opp_recfumblesIntegerNumber of opponent fumble recoveries
opp_rec_tdsfumblesIntegerNumber of opponent fumble recovery touchdowns
opp_rec_yardsfumblesIntegerNumber of opponent fumble recovery yards
out_of_boundsfumblesIntegerNumber of opponent fumbles out of bounds
own_recfumblesIntegerNumber of own fumble recoveries
own_rec_tdsfumblesIntegerNumber of own fumble recovery touchdowns
own_rec_yardsfumblesIntegerNumber of own fumble recovery yards
Game Statistics - Interception Returns (Team):
AttributeParent ElementTypeDescription
avg_yardsint_returnsDecimalAverage number of yards on interception returns
ex. 38.5
longestint_returnsIntegerNumber of yards of longest interception return
longest_touchdownint_returnsIntegerNumber of yards of longest interception return for a touchdown
returnsint_returnsIntegerNumber of interception returns
touchdownsint_returnsIntegerNumber of interception return touchdowns
yardsint_returnsIntegerNumber of total interception return yards
interceptionsinterceptionsIntegerNumber of interceptions
return_yardsinterceptionsIntegerNumber of interception return yards
returnedinterceptionsIntegerNumber of interceptions returned
Game Statistics - Kick Returns (Team):
AttributeParent ElementTypeDescription
avg_yardskick_returnsDecimalAverage number of yards on kick returns
ex. 19.5
faircatcheskick_returnsIntegerNumber of fair catches on kick returns
longestkick_returnsIntegerNumber of yards of longest kick return
longest_touchdownkick_returnsIntegerNumber of yards of longest kick return for a touchdown
returnskick_returnsIntegerNumber of kick returns
touchdownskick_returnsIntegerNumber of kick return touchdowns
yardskick_returnsIntegerNumber of total kick return yards
Game Statistics - Kickoffs (Team):
AttributeParent ElementTypeDescription
endzonekickoffsIntegerNumber of kickoffs into the endzone
inside_20kickoffsIntegerNumber of kickoffs inside the 20 yardline
kickoffskickoffsIntegerNumber of kickoffs
out_of_boundskickoffsIntegerNumber of kickoffs out of bounds
return_yardskickoffsIntegerNumber of total return yards on kickoffs
total_endzonekickoffsIntegerNumber of total kickoffs into the endzone (touchbacks + endzone kicks)
touchbackskickoffsIntegerNumber of touchbacks
yardskickoffsIntegerNumber of kickoff yards
Game Statistics - Miscellaneous Returns (Team):
AttributeParent ElementTypeDescription
blk_fg_touchdownsmisc_returnsIntegerNumber of blocked field goals returned for touchdowns
blk_punt_touchdownsmisc_returnsIntegerNumber of blocked punts returned for touchdowns
ez_rec_touchdownsmisc_returnsIntegerNumber of end zone recovery touchdowns
fg_touchdownsmisc_returnsIntegerNumber of field goal attempts returned for touchdowns
returnsmisc_returnsIntegerNumber of miscellaneous returns
touchdownsmisc_returnsIntegerNumber of miscellaneous returns for touchdowns
yardsmisc_returnsIntegerNumber of miscellaneous return yardage
Game Statistics - Passing (Team):
AttributeParent ElementTypeDescription
air_yardspassingIntegerNumber of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point)
attemptspassingIntegerNumber of pass attempts
avg_yardspassingDecimalAverage yards per pass attempt
ex. 7.22
cmp_pctpassingDecimalCompletion percentage
ex. 78.049
completionspassingIntegerNumber of pass completions
first_downspassingIntegerNumber of first downs
interceptionspassingIntegerNumber of interceptions thrown
int_touchdownspassingIntegerNumber of interceptions thrown returned for touchdowns
longestpassingIntegerNumber of yards of longest completed pass
longest_touchdownpassingIntegerNumber of yards of longest pass for a touchdown
net_yardspassingIntegerNumber of net yards passing
ratingpassingDecimalPasser rating
ex. 94.7
redzone_attemptspassingIntegerNumber of pass attempts in the red zone
sack_yardspassingIntegerNumber of sack yards
sackspassingIntegerNumber of sacks
touchdownspassingIntegerNumber of passing touchdowns
yardspassingIntegerNumber of passing yards
Game Statistics - Penalties (Team):
AttributeParent ElementTypeDescription
first_downspenaltiesIntegerNumber of penalties resulting in a first down
penaltiespenaltiesIntegerNumber of penalties
yardspenaltiesIntegerNumber of penalty yardage
Game Statistics - Punt Returns (Team):
AttributeParent ElementTypeDescription
avg_yardspunt_returnsDecimalAverage number of yards on punt returns
ex. 19.5
faircatchespunt_returnsIntegerNumber of fair catches on punt returns
longestpunt_returnsIntegerNumber of yards of longest punt return
longest_touchdownpunt_returnsIntegerNumber of yards of longest punt return for a touchdown
returnspunt_returnsIntegerNumber of punt returns
touchdownspunt_returnsIntegerNumber of punt return touchdowns
yardspunt_returnsIntegerNumber of total punt return yards
Game Statistics - Punts (Team):
AttributeParent ElementTypeDescription
attemptspuntsIntegerNumber of punt attempts
avg_net_yardspuntsDecimalAverage net yards on punts
ex. 28.75
avg_yardspuntsDecimalAverage yards on punts
ex. 43.75
blockedpuntsIntegerNumber of punts blocked
inside_20puntsIntegerNumber of punts inside the 20 yardline
longestpuntsIntegerNumber of yards of longest punt
net_yardspuntsIntegerNumber of total net punt yards
return_yardspuntsIntegerNumber of total return punt yards
out_of_boundspuntsIntegerNumber of punts out of bounds
return_yardspuntsIntegerNumber of total return yards on punts
touchbackspuntsIntegerNumber of touchbacks
yardspuntsIntegerNumber of punt yards
Game Statistics - Receiving (Team):
AttributeParent ElementTypeDescription
air_yardsreceivingIntegerNumber of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point)
avg_yardsreceivingDecimalAverage yards per reception
ex. 7.22
first_downsreceivingIntegerNumber of receiving first downs
longestreceivingIntegerNumber of yards of longest reception
longest_touchdownreceivingIntegerNumber of yards of longest receiving touchdown
receptionsreceivingIntegerNumber of receptions
redzone_targetsreceivingIntegerNumber of receiving red zone targets
targetsreceivingIntegerNumber of receiving targets
touchdownsreceivingIntegerNumber of receiving touchdowns
yardsreceivingIntegerNumber of receiving yards
yards_after_catchreceivingIntegerNumber of receiving yards after the catch
Game Statistics - Rushing (Team):
AttributeParent ElementTypeDescription
attemptsrushingIntegerNumber of rushing attempts
avg_yardsrushingDecimalAverage yards per rush
ex. 3.22
first_downsrushingIntegerNumber of rushing first downs
longestrushingIntegerNumber of yards of longest rush
longest_touchdownrushingIntegerNumber of yards of longest rushing touchdown
redzone_attemptsrushingIntegerNumber of rushing red zone attempts
tlostrushingIntegerNumber of rushing tackles for a loss
tlost_yardsrushingIntegerNumber of rushing tackles for a loss yardage
touchdownsrushingIntegerNumber of rushing touchdowns
yardsrushingIntegerNumber of rushing yards
Game Statistics - Special Conversions (Team):
AttributeParent ElementTypeDescription
defense_one_point_attemptsspecial_conversionsIntegerNumber of one-point defensive conversion attempts
defense_one_point_successesspecial_conversionsIntegerNumber of successful one-point defensive conversions
pass_one_point_attemptsspecial_conversionsIntegerNumber of one-point passing conversion attempts
pass_one_point_successesspecial_conversionsIntegerNumber of successful one-point passing conversions
rush_one_point_attemptsspecial_conversionsIntegerNumber of one-point rushing conversion attempts
rush_one_point_successesspecial_conversionsIntegerNumber of successful one-point rushing conversions
defense_three_point_attemptsspecial_conversionsIntegerNumber of three-point defensive conversion attempts
defense_three_point_successesspecial_conversionsIntegerNumber of successful three-point defensive conversions
pass_three_point_attemptsspecial_conversionsIntegerNumber of three-point passing conversion attempts
pass_three_point_successesspecial_conversionsIntegerNumber of successful three-point passing conversions
rush_three_point_attemptsspecial_conversionsIntegerNumber of three-point rushing conversion attempts
rush_three_point_successesspecial_conversionsIntegerNumber of successful three-point rushing conversions
Game Statistics - Touchdowns (Team):
AttributeParent ElementTypeDescription
fumble_returntouchdownsIntegerNumber of fumble return touchdowns
int_returntouchdownsIntegerNumber of interception return touchdowns
kick_returntouchdownsIntegerNumber of kick return touchdowns
othertouchdownsIntegerNumber of touchdowns outside of other categories. Common examples are blocked kicks or punts returned for scores.
passtouchdownsIntegerNumber of passing touchdowns
punt_returntouchdownsIntegerNumber of punt return touchdowns
rushtouchdownsIntegerNumber of rushing touchdowns
totaltouchdownsIntegerNumber of total touchdowns
total_returntouchdownsIntegerNumber of total return touchdowns
Game Statistics - Team Summary:
AttributeParent ElementTypeDescription
avg_gainsummaryDecimalAverage yards per play
ex. 7.6
fumblessummaryIntegerNumber of fumbles
lost_fumblessummaryIntegerNumber of fumbles lost
penaltiessummaryIntegerNumber of penalties
penalty_yardssummaryIntegerNumber of penalty yards
play_countsummaryIntegerNumber of offensive plays
possession_timesummaryIntegerTime of possession
ex. 36:38
return_yardssummaryIntegerNumber of return yards
rush_playssummaryIntegerNumber of rushing plays
safetiessummaryIntegerNumber of safeties
total_yardssummaryIntegerNumber of total yards
turnoverssummaryIntegerNumber of turnovers
League:
AttributeParent ElementTypeDescription
idsummary - seasonGUIDUnique season ID
ex. 234f28d6-b9d7-4881-a890-30b451c13aec
namesummary - seasonStringName of the season
PRE, REG, PST
typesummary - seasonStringType of the season
PRE, REG, PST
yearsummary - seasonIntegerYear of the season
idsummary - weekGUIDUnique week ID
ex. eb5f5b92-6a4e-42a7-b590-3f0ce7cc4736
sequencesummary - weekIntegerWeek sequence number
titlesummary - weekStringWeek title
Metadata:

Attribute

Parent Element

Type

Description

league

metadata

String

Alias of a league
ex. ufl

locale

metadata

String

Language code
ex. en (English)

match

metadata

GUID

Unique ID(s) of a game
ex. sd:match:932eea38-0d94-4db5-b861-69b1a0ca47dc,sr:match:32567857

operation

metadata

String

Operation of an update
update, delete

participant

metadata

GUID

Unique ID(s) of a team or player
ex. sd:team:c8797380-9677-11ec-9193-6b32ce92fd29,sr:competitor:882423

status

game

String

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

See our UFL FAQ for game status descriptions

version

metadata

String

Version of the API
ex. v6

Player:

Attribute

Parent Element

Type

Description

name

player

String

Full name of a player
ex. Deon Cain

id

player

GUID

Unique ID of a player
ex. f99a57a0-bdb7-11ed-a9cf-659b88c64826

jersey

player

Integer

Jersey number of a player

position

player

String

Position of a player

See our FAQ for a list of valid positions

Standings:
AttributeParent ElementTypeDescription
losseshome / away - recordIntegerNumber of team losses year-to-date before the game. Record is updated post-game based on the game outcome
tieshome / away - recordIntegerNumber of team ties year-to-date before the game. Record is updated post-game based on the game outcome
winshome / away - recordIntegerNumber of team wins year-to-date before the game. Record is updated post-game based on the game outcome
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
Venue:
AttributeParent ElementTypeDescription
addresssummary - venueStringAddress of a venue
ex. 1020 24th St N
capacitysummary - venueIntegerCapacity of a venue
ex. 47100
citysummary - venueStringCity of a venue
ex. Birmingham
countrysummary - venueStringCountry of a venue
ex. USA
idsummary - venueGUIDUnique ID of a venue
ex. b1f3fd20-90f4-11ec-bf38-efe8ff3d0b79
latvenue - locationDecimalLatitude of a venue
ex. 41.6587
lngvenue - locationDecimalLongitude of a venue
ex. -91.5511
namesummary - venueStringName of a venue
ex. Protective Stadium
roof_typesummary - venueStringRoof type of a venue
outdoor, dome, retractable_dome
sr_idsummary - venueStringUnique Sportradar venue ID
ex. sr:venue:58724
statesummary - venueStringState of a venue
ex. AL
surfacesummary - venueStringSurface type of a venue
turf, artificial
zipsummary - venueIntegerZIP code of a venue
ex. 35203