Syntax

https://api.sportradar.com/nfl/official/{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)

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
`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`
`participant`	Team or player id Example: `team_id=sd:team:4415b0a7-0f24-11e2-8525-18a905767e44` or `sd:player:e3181493-6a2a-4e95-aa6f-3fc1ddeb7512`
`status`	Game status `inprogress`, `created` Example: `status=inprogress`

Code Samples

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

url = URI("https://api.sportradar.com/nfl/official/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/nfl/official/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/nfl/official/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/nfl/official/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/nfl/official/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/nfl/official/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 Simulations to replay actual games at any time, on your own schedule. Push simulations are available as well.

Full Game Sample

Click here for Push samples (Events, Pulse, Statistics) of a complete game. Please note that the Push Statistics feed has been enhanced to include additional game data. See here for an updated Statistics sample.

Data Points

Boxscore

Attribute	Parent Element	Type	Description
`attendance`	`payload`	Integer	Attendance of a game ex. `73242`
`remaining_challenges`	`away`	Integer	Away team challenges remaining
`remaining_timeouts`	`away`	Integer	Away team timeouts remaining
`used_challenges`	`away`	Integer	Away team challenges used
`used_timeouts`	`away`	Integer	Away team timeouts used
`points`	`away`	Integer	Away team total points
`clock`	`payload`	String	Clock value of the game ex. `12:37`
`remaining_challenges`	`home`	Integer	Home team challenges remaining
`remaining_timeouts`	`home`	Integer	Home team timeouts remaining
`used_challenges`	`home`	Integer	Home team challenges used
`used_timeouts`	`home`	Integer	Home team timeouts used
`points`	`home`	Integer	Home team total points
`quarter`	`payload`	Integer	Quarter number of the game

Game

Attribute	Parent Element	Type	Description
`alias`	`away`	String	Away team alias ex. `MIN` (Minnesota)
`id`	`away`	GUID	Unique ID of the away team ex. `768c92aa-75ff-4a43-bcc0-f2798c2e1724`
`market`	`away`	String	Away team market name ex. `Minnesota`
`name`	`away`	String	Away team name ex. `Vikings`
`sr_id`	`away`	String	Unique Sportradar ID of the away team ex. `sr:competitor:4376`
`conference_game`	`payload`	Boolean	Signifies an in-Conference matchup ex. (NFC vs. NFC)
`coverage`	`payload`	String	Coverage level of a game `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)
`alias`	`home`	String	Home team alias ex. `GB` (Green Bay)
`id`	`home`	GUID	Unique ID of the home team ex. `7b112545-38e6-483c-a55c-96cf6ee49cb8`
`market`	`home`	String	Home team market name ex. `Green Bay`
`name`	`home`	String	Home team name ex. `Packers`
`sr_id`	`home`	String	Unique Sportradar ID of the home team ex. `sr:competitor:4391`
`id`	`payload`	GUID	Unique ID of a game ex. `13025660-aa95-4885-b33e-3a3554d4c4c3`
`neutral_site`	`payload`	Boolean	Signifies a game is held at a neutral site when `true`
`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`, `complete`, `closed`, `cancelled`, `delayed`, `suspended`, `postponed`, `time-tbd`, `if necessary`, `unnecessary` See our NFL FAQ for game status descriptions
`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`
`title`	`payload`	String	Game title ex. `NFC 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)

Attribute	Parent Element	Type	Description
`attempts`	`conversions`	Integer	Number of two-point conversion attempts
`category`	`conversions`	String	Category of conversion `pass`, `receive`, `rush`, `turnover`
`successes`	`conversions`	Integer	Number 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
`batted_passes`	`defense`	Integer	Number of batted passes
`blitzes`	`defense`	Integer	Number of blitzes
`combined`	`defense`	Integer	Number of combined (`assists` + `tackles`) defensive tackles *Does not include misc. or special teams tackles
`def_comps`	`defense`	Integer	Number of completed passes with a defensive player covering on the play
`def_targets`	`defense`	Integer	Number of defensive targets
`forced_fumbles`	`defense`	Integer	Number of forced fumbles
`fumble_recoveries`	`defense`	Integer	Number of fumble recoveries
`hurries`	`defense`	Integer	Number of hurries
`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
`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
`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)

Attribute	Parent Element	Type	Description
`attempts`	`extra_points`	Integer	Number of attempted extra points
`blocked`	`extra_points`	Integer	Number of blocked extra points
`made`	`extra_points`	Integer	Number of made extra points
`missed`	`extra_points`	Integer	Number of missed extra points
`pct`	`extra_points`	Decimal	Extra point percentage ex. `75.0`

Game Statistics - Field Goals (Player)

Attribute	Parent Element	Type	Description
`attempts`	`field_goals`	Integer	Number of attempted field goals
`attempts_19`	`field_goals`	Integer	Number of attempted field goals between 1-19 yards
`attempts_29`	`field_goals`	Integer	Number of attempted field goals between 20-29 yards
`attempts_39`	`field_goals`	Integer	Number of attempted field goals between 30-39 yards
`attempts_49`	`field_goals`	Integer	Number of attempted field goals between 40-49 yards
`attempts_50`	`field_goals`	Integer	Number of attempted field goals of 50 yards or more
`avg_yards`	`field_goals`	Decimal	Average number of yards on attempted field goals ex. `38.5`
`blocked`	`field_goals`	Integer	Number of blocked field goals
`longest`	`field_goals`	Integer	Number of yards of longest made field goal
`made`	`field_goals` - `player`	Integer	Number of made field goals
`made_19`	`field_goals`	Integer	Number of successful field goals between 1-19 yards
`made_29`	`field_goals`	Integer	Number of successful field goals between 20-29 yards
`made_39`	`field_goals`	Integer	Number of successful field goals between 30-39 yards
`made_49`	`field_goals`	Integer	Number of successful field goals between 40-49 yards
`made_50`	`field_goals`	Integer	Number of successful field goals of 50 yards or more
`missed`	`field_goals`	Integer	Number of missed field goals
`pct`	`field_goals`	Decimal	Field goal percentage ex. `75.0`
`yards`	`field_goals`	Integer	Number of total yards on successful field goals

Game Statistics - Fumbles (Player)

Attribute	Parent Element	Type	Description
`ez_rec_tds`	`fumbles`	Integer	Number of end zone fumble recovery touchdowns
`forced_fumbles`	`fumbles`	Integer	Number of forced fumbles
`fumbles`	`fumbles`	Integer	Number of fumbles
`lost_fumbles`	`fumbles`	Integer	Number of lost fumbles
`opp_rec`	`fumbles`	Integer	Number of opponent fumble recoveries
`opp_rec_tds`	`fumbles`	Integer	Number of opponent fumble recovery touchdowns
`opp_rec_yards`	`fumbles`	Integer	Number of opponent fumble recovery yards
`out_of_bounds`	`fumbles`	Integer	Number of opponent fumbles out of bounds
`own_rec`	`fumbles`	Integer	Number of own fumble recoveries
`own_rec_tds`	`fumbles`	Integer	Number of own fumble recovery touchdowns
`own_rec_yards`	`fumbles`	Integer	Number of own fumble recovery yards

Game Statistics - Interception Returns (Player)

Attribute	Parent Element	Type	Description
`avg_yards`	`int_returns`	Decimal	Average number of yards on interception returns ex. `38.5`
`longest`	`int_returns`	Integer	Number of yards of longest interception return
`longest_touchdown`	`int_returns`	Integer	Number of yards of longest interception return for a touchdown
`returns`	`int_returns`	Integer	Number of interception returns
`touchdowns`	`int_return`	Integer	Number of interception return touchdowns
`yards`	`int_returns`	Integer	Number of total interception return yards

Game Statistics - Kick Returns (Player)

Attribute	Parent Element	Type	Description
`avg_yards`	`kick_returns`	Decimal	Average number of yards on kick returns ex. `19.5`
`faircatches`	`kick_returns`	Integer	Number of fair catches on kick returns
`longest`	`kick_returns`	Integer	Number of yards of longest kick return
`longest_touchdown`	`kick_returns`	Integer	Number of yards of longest kick return for a touchdown
`returns`	`kick_returns`	Integer	Number of kick returns
`touchdowns`	`kick_returns`	Integer	Number of kick return touchdowns
`yards`	`kick_returns`	Integer	Number of total kick return yards

Game Statistics - Kickoffs (Player)

Attribute	Parent Element	Type	Description
`endzone`	`kickoffs`	Integer	Number of kickoffs into the endzone
`inside_20`	`kickoffs`	Integer	Number of kickoffs inside the 20 yardline
`kickoffs`	`kickoffs`	Integer	Number of kickoffs
`onside_attempts`	`kickoffs`	Integer	Number of onside kickoff attempts
`onside_successes`	`kickoffs`	Integer	Number of onside kickoff successes
`out_of_bounds`	`kickoffs`	Integer	Number of kickoffs out of bounds
`return_yards`	`kickoffs`	Integer	Number of total return yards on kickoffs
`squib_kicks`	`kickoffs`	Integer	Number of squib kicks
`total_endzone`	`kickoffs`	Integer	Number of total kickoffs into the endzone (touchbacks + endzone kicks)
`touchbacks`	`kickoffs`	Integer	Number of touchbacks
`yards`	`kickoffs`	Integer	Number of kickoff yards

Game Statistics - Passing (Player)

Attribute	Parent Element	Type	Description
`air_yards`	`passing`	Integer	Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point)
`attempts`	`passing`	Integer	Number of pass attempts
`avg_pocket_time`	`passing`	Double	Average time spent in the pocket ex. `2.477`
`avg_yards`	`passing`	Decimal	Average yards per pass attempt ex. `7.22`
`batted_passes`	`passing`	Integer	Number of batted pass attempts
`blitzes`	`passing`	Integer	Number of blitzes
`cmp_pct`	`passing`	Decimal	Completion percentage ex. `78.049`
`completions`	`passing`	Integer	Number of pass completions
`defended_passes`	`passing`	Integer	Number of pass attempts defended
`dropped_passes`	`passing`	Integer	Number of pass attempts dropped
`first_downs`	`passing`	Integer	Number of first downs
`hurries`	`passing`	Integer	Number of pass hurries
`interceptions`	`passing`	Integer	Number of interceptions thrown
`int_touchdowns`	`passing`	Integer	Number of interceptions thrown returned for touchdowns
`knockdowns`	`passing`	Integer	Number of knockdowns
`longest`	`passing`	Integer	Number of yards of longest completed pass
`longest_touchdown`	`passing`	Integer	Number of yards of longest pass for a touchdown
`on_target_throws`	`passing`	Integer	Number of on target throws
`pocket_time`	`passing`	Double	Time spent in the pocket ex. `101.573`
`poor_throws`	`passing`	Integer	Number of poor throws
`rating`	`passing`	Decimal	Passer rating ex. `94.7`
`redzone_attempts`	`passing`	Integer	Number of pass attempts in the red zone
`sack_yards`	`passing`	Integer	Number of sack yards
`sacks`	`passing`	Integer	Number of sacks
`spikes`	`passing`	Integer	Number of spikes
`throw_aways`	`passing`	Integer	Number of throw aways
`touchdowns`	`passing`	Integer	Number of passing touchdowns
`yards`	`passing`	Integer	Number of passing yards

Game Statistics - Penalties (Player)

Attribute	Parent Element	Type	Description
`first_downs`	`penalties`	Integer	Number of penalties resulting in a first down
`penalties`	`penalties`	Integer	Number of penalties
`yards`	`penalties`	Integer	Number of penalty yardage

Game Statistics - Punt Returns (Player)

Attribute	Parent Element	Type	Description
`avg_yards`	`punt_returns`	Decimal	Average number of yards on punt returns ex. `19.5`
`faircatches`	`punt_returns`	Integer	Number of fair catches on punt returns
`longest`	`punt_returns`	Integer	Number of yards of longest punt return
`longest_touchdown`	`punt_returns`	Integer	Number of yards of longest punt return for a touchdown
`returns`	`punt_returns`	Integer	Number of punt returns
`touchdowns`	`punt_returns`	Integer	Number of punt return touchdowns
`yards`	`punt_returns`	Integer	Number of total punt return yards

Game Statistics - Punts (Player)

Attribute	Parent Element	Type	Description
`attempts`	`punts`	Integer	Number of punt attempts
`avg_hang_time`	`punts`	Double	Average hang time on punts ex. `4.163`
`avg_net_yards`	`punts`	Decimal	Average net yards on punts ex. `28.75`
`avg_yards`	`punts`	Decimal	Average yards on punts ex. `43.75`
`blocked`	`punts`	Integer	Number of punts blocked
`hang_time`	`punts`	Double	Total hang time on punts ex. `16.65`
`inside_20`	`punts`	Integer	Number of punts inside the 20 yardline
`longest`	`punts`	Integer	Number of yards of longest punt
`net_yards`	`punts`	Integer	Number of total net punt yards
`return_yards`	`punts`	Integer	Number of total return punt yards
`return_yards`	`punts`	Integer	Number of total return yards on punts
`touchbacks`	`punts`	Integer	Number of touchbacks
`yards`	`punts`	Integer	Number of punt yards

Game Statistics - Receiving (Player)

Attribute	Parent Element	Type	Description
`air_yards`	`receiving`	Integer	Number 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_yards`	`receiving`	Decimal	Average yards per reception ex. `7.22`
`broken_tackles`	`receiving`	Integer	Number of receiving broken tackles
`catchable_passes`	`receiving`	Integer	Number of catchable passes
`dropped_passes`	`receiving`	Integer	Number of dropped passes
`first_downs`	`receiving`	Integer	Number of receiving first downs
`longest`	`receiving`	Integer	Number of yards of longest reception
`longest_touchdown`	`receiving`	Integer	Number of yards of longest receiving touchdown
`receptions`	`receiving`	Integer	Number of receptions
`redzone_targets`	`receiving`	Integer	Number of receiving red zone targets
`targets`	`receiving`	Integer	Number of receiving targets
`touchdowns`	`receiving`	Integer	Number of receiving touchdowns
`yards`	`receiving`	Integer	Number of receiving yards
`yards_after_catch`	`receiving`	Integer	Number of receiving yards after the catch
`yards_after_contact`	`receiving`	Integer	Number of receiving yards after contact

Game Statistics - Rushing (Player)

Attribute	Parent Element	Type	Description
`attempts`	`rushing`	Integer	Number of rushing attempts
`avg_yards`	`rushing`	Decimal	Average yards per rush ex. `3.22`
`broken_tackles`	`rushing`	Integer	Number of rushing broken tackles
`first_downs`	`rushing`	Integer	Number of rushing first downs
`kneel_downs`	`rushing`	Integer	Number of rushing kneel downs
`longest`	`rushing`	Integer	Number of yards of longest rush
`longest_touchdown`	`rushing`	Integer	Number of yards of longest rushing touchdown
`redzone_attempts`	`rushing`	Integer	Number of rushing red zone attempts
`lateral`	`rushing`	Integer	Number of rushing laterals
`scrambles`	`rushing`	Integer	Number of rushing scrambles
`tlost`	`rushing`	Integer	Number of rushing tackles for a loss
`tlost_yards`	`rushing`	Integer	Number of rushing tackles for a loss yardage
`touchdowns`	`rushing`	Integer	Number of rushing touchdowns
`yards`	`rushing`	Integer	Number of rushing yards
`yards_after_contact`	`rushing`	Integer	Number of rushing yards after contact

Game Statistics - Conversions (Team)

Attribute	Parent Element	Type	Description
`def_conv_attempts`	`extra_points`	Integer	Number of defensive two-point conversion attempts
`def_conv_successes`	`extra_points`	Integer	Number of successful defensive two-point conversions
`pass_conv_attempts`	`extra_points`	Integer	Number of two-point conversion passing attempts
`pass_conv_successes`	`extra_points`	Integer	Number of successful passing two-point conversions
`rush_conv_attempts`	`extra_points`	Integer	Number of two-point conversion rushing attempts
`rush_conv_successes`	`extra_points`	Integer	Number 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
`batted_passes`	`defense`	Integer	Number of batted passes
`blitzes`	`defense`	Integer	Number of blitzes
`combined`	`defense`	Integer	Number of combined (`assists` + `tackles`) defensive tackles *Does not include misc. or special teams tackles
`def_comps`	`defense`	Integer	Number of completed passes with a defensive player covering on the play
`def_targets`	`defense`	Integer	Number of defensive targets
`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
`hurries`	`defense`	Integer	Number of hurries
`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
`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)

Attribute	Parent Element	Type	Description
`attempts`	`efficiency` - `thirddown`	Integer	Number of third down attempts
`successes`	`efficiency` - `thirddown`	Integer	Number of third down successes
`pct`	`efficiency` - `thirddown`	Decimal	Third down conversion percentage ex. `61.538`
`attempts`	`efficiency` - `fourthdown`	Integer	Number of fourth down attempts
`successes`	`efficiency` - `fourthdown`	Integer	Number of fourth down successes
`pct`	`efficiency` - `fourthdown`	Decimal	Fourth down conversion percentage ex. `50.0`
`attempts`	`efficiency` - `goaltogo`	Integer	Number of goal-to-go attempts (eg. 1st & Goal, 2nd & Goal, etc.)
`successes`	`efficiency` - `goaltogo`	Integer	Number of goal-to-go successes (eg. 1st & Goal, 2nd & Goal, etc.)
`pct`	`efficiency` - `goaltogo`	Decimal	Goal-to-go conversion percentage (eg. 1st & Goal, 2nd & Goal, etc.) ex. `100.0`
`attempts`	`efficiency` - `redzone`	Integer	Number of red zone attempts
`successes`	`efficiency` - `redzone`	Integer	Number of red zone successes
`pct`	`efficiency` - `redzone`	Decimal	Red zone conversion percentage ex. `80.0`

Game Statistics - Extra Points (Team)

Attribute	Parent Element	Type	Description
`kick_attempts`	`extra_points`	Integer	Number of attempted extra points
`kick_blocked`	`extra_points`	Integer	Number of blocked extra points
`kick_made`	`extra_points`	Integer	Number of made extra points
`missed`	`extra_points`	Integer	Number of missed extra points

Game Statistics - Field Goals (Team)

Attribute	Parent Element	Type	Description
`attempts`	`field_goals`	Integer	Number of attempted field goals
`attempts_19`	`field_goals`	Integer	Number of attempted field goals between 1-19 yards
`attempts_29`	`field_goals`	Integer	Number of attempted field goals between 20-29 yards
`attempts_39`	`field_goals`	Integer	Number of attempted field goals between 30-39 yards
`attempts_49`	`field_goals`	Integer	Number of attempted field goals between 40-49 yards
`attempts_50`	`field_goals`	Integer	Number of attempted field goals of 50 yards or more
`avg_yards`	`field_goals`	Decimal	Average number of yards on attempted field goals ex. `38.5`
`blocked`	`field_goals`	Integer	Number of blocked field goals
`longest`	`field_goals`	Integer	Number of yards of longest made field goal
`made`	`field_goals` - `player`	Integer	Number of made field goals
`made_19`	`field_goals`	Integer	Number of successful field goals between 1-19 yards
`made_29`	`field_goals`	Integer	Number of successful field goals between 20-29 yards
`made_39`	`field_goals`	Integer	Number of successful field goals between 30-39 yards
`made_49`	`field_goals`	Integer	Number of successful field goals between 40-49 yards
`made_50`	`field_goals`	Integer	Number of successful field goals of 50 yards or more
`missed`	`field_goals`	Integer	Number of missed field goals
`yards`	`field_goals`	Integer	Number of total yards on successful field goals

Game Statistics - First Downs (Team)

Attribute	Parent Element	Type	Description
`pass`	`first_downs`	Integer	Number of passing first downs
`penalty`	`first_downs`	Integer	Number of first downs due to penalty
`rush`	`first_downs`	Integer	Number of rushing first downs
`total`	`first_downs`	Integer	Number of total first downs

Game Statistics - Fumbles (Team)

Attribute	Parent Element	Type	Description
`ez_rec_tds`	`fumbles`	Integer	Number of end zone fumble recovery touchdowns
`forced_fumbles`	`fumbles`	Integer	Number of forced fumbles
`fumbles`	`fumbles`	Integer	Number of fumbles
`lost_fumbles`	`fumbles`	Integer	Number of lost fumbles
`opp_rec`	`fumbles`	Integer	Number of opponent fumble recoveries
`opp_rec_tds`	`fumbles`	Integer	Number of opponent fumble recovery touchdowns
`opp_rec_yards`	`fumbles`	Integer	Number of opponent fumble recovery yards
`out_of_bounds`	`fumbles`	Integer	Number of opponent fumbles out of bounds
`own_rec`	`fumbles`	Integer	Number of own fumble recoveries
`own_rec_tds`	`fumbles`	Integer	Number of own fumble recovery touchdowns
`own_rec_yards`	`fumbles`	Integer	Number of own fumble recovery yards

Game Statistics - Interception Returns (Team)

Attribute	Parent Element	Type	Description
`avg_yards`	`int_returns`	Decimal	Average number of yards on interception returns ex. `38.5`
`longest`	`int_returns`	Integer	Number of yards of longest interception return
`longest_touchdown`	`int_returns`	Integer	Number of yards of longest interception return for a touchdown
`returns`	`int_returns`	Integer	Number of interception returns
`touchdowns`	`int_returns`	Integer	Number of interception return touchdowns
`yards`	`int_returns`	Integer	Number of total interception return yards
`interceptions`	`interceptions`	Integer	Number of interceptions
`return_yards`	`interceptions`	Integer	Number of interception return yards
`returned`	`interceptions`	Integer	Number of interceptions returned

Game Statistics - Kick Returns (Team)

Attribute	Parent Element	Type	Description
`avg_yards`	`kick_returns`	Decimal	Average number of yards on kick returns ex. `19.5`
`faircatches`	`kick_returns`	Integer	Number of fair catches on kick returns
`longest`	`kick_returns`	Integer	Number of yards of longest kick return
`longest_touchdown`	`kick_returns`	Integer	Number of yards of longest kick return for a touchdown
`returns`	`kick_returns`	Integer	Number of kick returns
`touchdowns`	`kick_returns`	Integer	Number of kick return touchdowns
`yards`	`kick_returns`	Integer	Number of total kick return yards

Game Statistics - Kickoffs (Team)

Attribute	Parent Element	Type	Description
`endzone`	`kickoffs`	Integer	Number of kickoffs into the endzone
`inside_20`	`kickoffs`	Integer	Number of kickoffs inside the 20 yardline
`kickoffs`	`kickoffs`	Integer	Number of kickoffs
`out_of_bounds`	`kickoffs`	Integer	Number of kickoffs out of bounds
`return_yards`	`kickoffs`	Integer	Number of total return yards on kickoffs
`total_endzone`	`kickoffs`	Integer	Number of total kickoffs into the endzone (touchbacks + endzone kicks)
`touchbacks`	`kickoffs`	Integer	Number of touchbacks
`yards`	`kickoffs`	Integer	Number of kickoff yards

Game Statistics - Miscellaneous Returns (Team)

Attribute	Parent Element	Type	Description
`blk_fg_touchdowns`	`misc_returns`	Integer	Number of blocked field goals returned for touchdowns
`blk_punt_touchdowns`	`misc_returns`	Integer	Number of blocked punts returned for touchdowns
`ez_rec_touchdowns`	`misc_returns`	Integer	Number of end zone recovery touchdowns
`fg_touchdowns`	`misc_returns`	Integer	Number of field goal attempts returned for touchdowns
`returns`	`misc_returns`	Integer	Number of miscellaneous returns
`touchdowns`	`misc_returns`	Integer	Number of miscellaneous returns for touchdowns
`yards`	`misc_returns`	Integer	Number of miscellaneous return yardage

Game Statistics - Passing (Team)

Attribute	Parent Element	Type	Description
`air_yards`	`passing`	Integer	Number of air yards (the amount of yards the ball traveled in the air on a passing play, from line of scrimmage to contact point)
`attempts`	`passing`	Integer	Number of pass attempts
`avg_pocket_time`	`passing`	Double	Average time spent in the pocket ex. `2.477`
`avg_yards`	`passing`	Decimal	Average yards per pass attempt ex. `7.22`
`batted_passes`	`passing`	Integer	Number of batted pass attempts
`blitzes`	`passing`	Integer	Number of blitzes
`cmp_pct`	`passing`	Decimal	Completion percentage ex. `78.049`
`completions`	`passing`	Integer	Number of pass completions
`defended_passes`	`passing`	Integer	Number of pass attempts defended
`dropped_passes`	`passing`	Integer	Number of pass attempts dropped
`first_downs`	`passing`	Integer	Number of first downs
`hurries`	`passing`	Integer	Number of pass hurries
`interceptions`	`passing`	Integer	Number of interceptions thrown
`int_touchdowns`	`passing`	Integer	Number of interceptions thrown returned for touchdowns
`knockdowns`	`passing`	Integer	Number of knockdowns
`longest`	`passing`	Integer	Number of yards of longest completed pass
`longest_touchdown`	`passing`	Integer	Number of yards of longest pass for a touchdown
`net_yards`	`passing`	Integer	Number of net yards passing
`on_target_throws`	`passing`	Integer	Number of on target throws
`pocket_time`	`passing`	Double	Time spent in the pocket ex. `101.573`
`poor_throws`	`passing`	Integer	Number of poor throws
`rating`	`passing`	Decimal	Passer rating ex. `94.7`
`redzone_attempts`	`passing`	Integer	Number of pass attempts in the red zone
`sack_yards`	`passing`	Integer	Number of sack yards
`sacks`	`passing`	Integer	Number of sacks
`spikes`	`passing`	Integer	Number of spikes
`throw_aways`	`passing`	Integer	Number of throw aways
`touchdowns`	`passing`	Integer	Number of passing touchdowns
`yards`	`passing`	Integer	Number of passing yards

Game Statistics - Penalties (Team)

Attribute	Parent Element	Type	Description
`first_downs`	`penalties`	Integer	Number of penalties resulting in a first down
`penalties`	`penalties`	Integer	Number of penalties
`yards`	`penalties`	Integer	Number of penalty yardage

Game Statistics - Punt Returns (Team)

Attribute	Parent Element	Type	Description
`avg_yards`	`punt_returns`	Decimal	Average number of yards on punt returns ex. `19.5`
`faircatches`	`punt_returns`	Integer	Number of fair catches on punt returns
`longest`	`punt_returns`	Integer	Number of yards of longest punt return
`longest_touchdown`	`punt_returns`	Integer	Number of yards of longest punt return for a touchdown
`returns`	`punt_returns`	Integer	Number of punt returns
`touchdowns`	`punt_returns`	Integer	Number of punt return touchdowns
`yards`	`punt_returns`	Integer	Number of total punt return yards

Game Statistics - Punts (Team)

Attribute	Parent Element	Type	Description
`attempts`	`punts`	Integer	Number of punt attempts
`avg_hang_time`	`punts`	Double	Average hang time on punts ex. `4.163`
`avg_net_yards`	`punts`	Decimal	Average net yards on punts ex. `28.75`
`avg_yards`	`punts`	Decimal	Average yards on punts ex. `43.75`
`blocked`	`punts`	Integer	Number of punts blocked
`hang_time`	`punts`	Double	Total hang time on punts ex. `16.65`
`inside_20`	`punts`	Integer	Number of punts inside the 20 yardline
`longest`	`punts`	Integer	Number of yards of longest punt
`net_yards`	`punts`	Integer	Number of total net punt yards
`return_yards`	`punts`	Integer	Number of total return punt yards
`out_of_bounds`	`punts`	Integer	Number of punts out of bounds
`return_yards`	`punts`	Integer	Number of total return yards on punts
`touchbacks`	`punts`	Integer	Number of touchbacks
`yards`	`punts`	Integer	Number of punt yards

Game Statistics - Receiving (Team)

Attribute	Parent Element	Type	Description
`air_yards`	`receiving`	Integer	Number 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_yards`	`receiving`	Decimal	Average yards per reception ex. `7.22`
`broken_tackles`	`receiving`	Integer	Number of receiving broken tackles
`catchable_passes`	`receiving`	Integer	Number of catchable passes
`dropped_passes`	`receiving`	Integer	Number of dropped passes
`first_downs`	`receiving`	Integer	Number of receiving first downs
`longest`	`receiving`	Integer	Number of yards of longest reception
`longest_touchdown`	`receiving`	Integer	Number of yards of longest receiving touchdown
`receptions`	`receiving`	Integer	Number of receptions
`redzone_targets`	`receiving`	Integer	Number of receiving red zone targets
`targets`	`receiving`	Integer	Number of receiving targets
`touchdowns`	`receiving`	Integer	Number of receiving touchdowns
`yards`	`receiving`	Integer	Number of receiving yards
`yards_after_catch`	`receiving`	Integer	Number of receiving yards after the catch
`yards_after_contact`	`receiving`	Integer	Number of receiving yards after contact

Game Statistics - Rushing (Team)

Attribute	Parent Element	Type	Description
`attempts`	`rushing`	Integer	Number of rushing attempts
`avg_yards`	`rushing`	Decimal	Average yards per rush ex. `3.22`
`broken_tackles`	`rushing`	Integer	Number of rushing broken tackles
`first_downs`	`rushing`	Integer	Number of rushing first downs
`kneel_downs`	`rushing`	Integer	Number of rushing kneel downs
`longest`	`rushing`	Integer	Number of yards of longest rush
`longest_touchdown`	`rushing`	Integer	Number of yards of longest rushing touchdown
`redzone_attempts`	`rushing`	Integer	Number of rushing red zone attempts
`scrambles`	`rushing`	Integer	Number of rushing scrambles
`tlost`	`rushing`	Integer	Number of rushing tackles for a loss
`tlost_yards`	`rushing`	Integer	Number of rushing tackles for a loss yardage
`touchdowns`	`rushing`	Integer	Number of rushing touchdowns
`yards`	`rushing`	Integer	Number of rushing yards
`yards_after_contact`	`rushing`	Integer	Number of rushing yards after contact

Game Statistics - Touchdowns (Team)

Attribute	Parent Element	Type	Description
`fumble_return`	`touchdowns`	Integer	Number of fumble return touchdowns
`int_return`	`touchdowns`	Integer	Number of interception return touchdowns
`kick_return`	`touchdowns`	Integer	Number of kick return touchdowns
`other`	`touchdowns`	Integer	Number of touchdowns outside of other categories. Common examples are blocked kicks or punts returned for scores.
`pass`	`touchdowns`	Integer	Number of passing touchdowns
`punt_return`	`touchdowns`	Integer	Number of punt return touchdowns
`rush`	`touchdowns`	Integer	Number of rushing touchdowns
`total`	`touchdowns`	Integer	Number of total touchdowns
`total_return`	`touchdowns`	Integer	Number of total return touchdowns

Game Statistics - Team Summary

Attribute	Parent Element	Type	Description
`avg_gain`	`summary`	Decimal	Average yards per play ex. `7.6`
`fumbles`	`summary`	Integer	Number of fumbles
`lost_fumbles`	`summary`	Integer	Number of fumbles lost
`penalties`	`summary`	Integer	Number of penalties
`penalty_yards`	`summary`	Integer	Number of penalty yards
`play_count`	`summary`	Integer	Number of offensive plays
`possession_time`	`summary`	Integer	Time of possession ex. `36:38`
`return_yards`	`summary`	Integer	Number of return yards
`rush_plays`	`summary`	Integer	Number of rushing plays
`safeties`	`summary`	Integer	Number of safeties
`total_yards`	`summary`	Integer	Number of total yards
`turnovers`	`summary`	Integer	Number of turnovers

League

Attribute	Parent Element	Type	Description
`id`	`summary` - `season`	GUID	Unique season ID ex. `75749c10-56c1-4ae0-9d1e-2689708debdf`
`name`	`summary` - `season`	String	Name of the season `PRE`,`REG`,`PST`
`type`	`summary` - `season`	String	Type of the season `PRE`,`REG`,`PST`
`year`	`summary` - `season`	Integer	Year of the season
`id`	`summary` - `week`	GUID	Unique week ID ex. `57b447ce-bc66-47f7-9760-89d328d3db9f`
`sequence`	`summary` - `week`	Integer	Week sequence number
`title`	`summary` - `week`	String	Week title

Metadata

Attribute	Parent Element	Type	Description
`league`	`metadata`	String	Alias of a league ex. `nfl`
`locale`	`metadata`	String	Language code ex. `en` (English)
`match`	`metadata`	GUID	Unique ID(s) of a game ex. `sd:match:1a57777c-7c57-43fa-bf08-66bffc204fd1,sr:match:33623353`
`operation`	`metadata`	String	Operation of an update `update`, `delete`
`participant`	`metadata`	GUID	Unique ID(s) of a team or player ex. `sd:team:1f6dcffb-9823-43cd-9ff4-e7a8466749b5,sr:competitor:4429`
`status`	`metadata`	String	The status of a game `scheduled`, `inprogress`, `complete`, `closed`, `wdelay`, `fdelay`, `odelay`, `canceled`, `unnecessary`, `if-necessary`, `postponed`, `suspended`, `maintenance` See our NFL FAQ for game status descriptions
`version`	`metadata`	String	Version of the API ex. `v7`

Player

Attribute	Parent Element	Type	Description
`name`	`player`	String	Full name of a player ex. `George Kittle`
`id`	`player`	GUID	Unique ID of a player ex. `7e648a0b-fdc8-4661-a587-5826f2cac11b`
`jersey`	`player`	String	Jersey number of a player
`position`	`player`	String	Position of an NFL player
`sr_id`	`player`	String	Unique Sportradar player ID ex. `sr:player:828235`

Standings

Attribute	Parent Element	Type	Description
`losses`	`home` / `away` - `record`	Integer	Number of team losses year-to-date before the game. Record is updated post-game based on the game outcome
`ties`	`home` / `away` - `record`	Integer	Number of team ties year-to-date before the game. Record is updated post-game based on the game outcome
`wins`	`home` / `away` - `record`	Integer	Number of team wins year-to-date before the game. Record is updated post-game based on the game outcome

Team

Attribute	Parent Element	Type	Description
`alias`	`team`	String	Team alias ex. `MIN` (Minnesota)
`id`	`team`	GUID	Unique ID of a team ex. `82d2d380-3834-4938-835f-aec541e5ece7`
`market`	`team`	String	Team market name ex. `Minnesota`
`name`	`team`	String	Team name ex. `Vikings`
`sr_id`	`team`	String	Unique Sportradar ID of a team ex. `sr:competitor:4324`

Venue

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