Docs
Coverage MatrixDocumentationRelease LogLog In

Game Roster

NFL Game Roster provides complete game roster information for each team, including game status and player profile data.

⏱️

Update Frequency

TTL / Cache: This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.

Data Updates: Realtime


Data Points

Boxscore:
AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game
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
clockgameStringClock 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
quartergameIntegerQuarter number of the game
Officials:
AttributeParent ElementTypeDescription
assignmentofficialStringOfficial assignment
ex. linejudge or replayofficial
full_nameofficialStringFull name of an official
ex. Brad Rogers
numberofficialIntegerJersey number of an official
Draft:
AttributeParent ElementTypeDescription
numberdraftIntegerDraft pick number of a player
rounddraftIntegerDraft pick round of a player
yeardraftIntegerDraft year of a player
aliasdraft - teamStringDraft team alias
ex. MIN (Minnesota)
iddraft - teamGUIDUnique ID of a draft team
ex. 82d2d380-3834-4938-835f-aec541e5ece7
marketdraft - teamStringDraft team market name
ex. Minnesota
namedraft - teamStringDraft team name
ex. Vikings
sr_iddraft - teamStringUnique Sportradar ID of a draft team
ex. sr:competitor:4324
Game:
AttributeParent ElementTypeDescription
aliasawayStringAway team alias
ex. MIN (Minnesota)
idawayGUIDUnique ID of the away team
ex. 768c92aa-75ff-4a43-bcc0-f2798c2e1724
marketawayStringAway team market name
ex. Minnesota
nameawayStringAway team name
ex. Vikings
sr_idawayStringUnique Sportradar ID of the away team
ex. sr:competitor:4376
conference_gamegameBooleanSignifies an in-Conference matchup
ex. (NFC vs. NFC)
durationgameStringDuration of the game
ex. 2:52
entry_modegameStringType of data entry for the game
LDE (Live Data Entry)
game_typegameStringType of game
regular, playoff
aliashomeStringHome team alias
ex. GB (Green Bay)
idhomeGUIDUnique ID of the home team
ex. 7b112545-38e6-483c-a55c-96cf6ee49cb8
markethomeStringHome team market name
ex. Green Bay
namehomeStringHome team name
ex. Packers
sr_idhomeStringUnique Sportradar ID of the home team
ex. sr:competitor:4391
idgameGUIDUnique ID of a game
ex. 13025660-aa95-4885-b33e-3a3554d4c4c3
neutral_sitegameBooleanSignifies a game is held at a neutral site
numbergameIntegerGame number
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, complete, closed, cancelled, delayed, suspended, postponed, time-tbd, if necessary, unnecessary

See our NFL FAQ for game status descriptions
titlegameStringGame title
ex. NFC Championship
conditionweatherStringWeather conditions for a game
ex. Partly cloudy
humidityweatherByteHumidity conditions for a game
ex. 44
tempweatherByteTemperature of a game in Fahrenheit
ex. 57
directionwindStringWind direction for a game
ex. N
speedwindByteWind speed for a game in MPH
League:
AttributeParent ElementTypeDescription
idseasonGUIDUnique season ID
ex. 75749c10-56c1-4ae0-9d1e-2689708debdf
nameseasonStringName of the season
PRE, REG, PST
typeseasonStringType of the season
PRE, REG, PST
yearseasonIntegerYear of the season
idweekGUIDUnique week ID
ex. 57b447ce-bc66-47f7-9760-89d328d3db9f
sequenceweekIntegerWeek sequence number
titleweekStringWeek title
Player:
AttributeParent ElementTypeDescription
abbr_nameplayerStringAbbreviated name of a player
ex. P.Mahomes
ageplayerIntegerAge of a player at the time of the game
birth_dateplayerDatePlayer date of birth
ex. 1995-09-17
birth_placeplayerStringBirthplace of a player
ex. Tyler, TX, USA
collegeplayerStringCollege attended
ex. Texas Tech
college_confplayerStringCollege Conference
ex. Big Twelve
first_nameplayerStringFirst name of a player
ex. Patrick
nameplayerStringFull name of a player
ex. Patrick Mahomes
heightplayerIntegerHeight in inches
high_schoolplayerStringHigh school attended
ex. Whitehouse (TX)
idplayerGUIDUnique ID of a player
ex. 11cad59d-90dd-449c-a839-dddaba4fe16c
in_game_statusplayerStringIn-game status of a player updated in real-time
active, probable, questionable, doubtful, out, benched, unknown
jerseyplayerIntegerJersey number of a player
last_nameplayerStringLast name of a player
ex. Mahomes
name_suffixplayerStringSuffix of a player
ex. Jr.
positionplayerStringPosition of a player

See our FAQ for a list of valid positions
preferred_nameplayerStringPreferred name of a player
sr_idplayerGUIDUnique Sportradar ID of a player
ex. sr:player:1129537
statusplayerStringGame status of a player
deactivated, dnp(Did Not Play), played, started
See our FAQ for more info on these player game statuses
weightplayerDecimalWeight in lbs
Standings:
AttributeParent ElementTypeDescription
lossesrecordIntegerNumber of team losses year-to-date before the game. Record is updated post-game based on the game outcome
tiesrecordIntegerNumber of team ties year-to-date before the game. Record is updated post-game based on the game outcome
winsrecordIntegerNumber of team wins year-to-date before the game. Record is updated post-game based on the game outcome
Coaches:
AttributeParent ElementTypeDescription
first_namehome / away - coachStringFirst name of a coach
ex. Dennis
full_namehome / away - coachStringFull name of a coach
ex. Dennis Allen
idhome / away - coachGUIDUnique ID of a coach
ex. ef1b4704-0ce4-4977-a882-2b14413dd2d2
last_namehome / away - coachStringLast name of a coach
ex. Allen
name_suffixhome / away - coachStringSuffix of a coach
ex. Jr.
positionhome / away - coachStringType of coach
ex. Head Coach or Offensive Coordinator
Team:
AttributeParent ElementTypeDescription
aliasteamStringTeam alias
ex. MIN (Minnesota)
idteamGUIDUnique ID of a team
ex. 82d2d380-3834-4938-835f-aec541e5ece7
marketteamStringTeam market name
ex. Minnesota
nameteamStringTeam name
ex. Vikings
sr_idteamStringUnique Sportradar ID of a team
ex. sr:competitor:4324
Venue:
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue
ex. 900 S 5th Street
capacityvenueIntegerCapacity of a venue
ex. 72220
cityvenueStringCity of a venue
ex. Minneapolis
countryvenueStringCountry of a venue
ex. USA
idvenueGUIDUnique ID of a venue
ex. 6a72e5ca-33d0-40af-8e6b-b32a4d3d9346
latvenue - locationDecimalLatitude of a venue
ex. 29.684735
lngvenue - locationDecimalLongitude of a venue
ex. -95.410725
namevenueStringName of a venue
ex. U.S. Bank Stadium
roof_typevenueStringRoof type of a venue
outdoor, dome, retractable_dome
sr_idvenueStringUnique Sportradar venue ID
ex. sr:venue:2402
statevenueStringState of a venue
ex. MN
surfacevenueStringSurface type of a venue
turf, artificial
zipvenueIntegerZIP code of a venue
ex. 77054
Language
Authorization
Query
Click Try It! to start a request and see the response here!