Integration GuidesReference Docs
Coverage MatrixDocumentationRelease LogLog InContact Us

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

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
AttributeParent ElementTypeDescription
assignmentofficialStringOfficial assignment
ex. linejudge or replayofficial
full_nameofficialStringFull name of an official
ex. Brad Rogers
numberofficialIntegerJersey number of an official
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
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
internetbroadcastStringName of a game's internet stream
ex. ESPN+
networkbroadcastStringName of a game's broadcast network
ex. Amazon Prime Video
radiobroadcastStringName of a game's radio station
ex. Sirius 134, XM 231
satellitebroadcastStringName of a game's broadcast satellite station
ex. ESPN Ocho
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
awaytime_zonesStringTime zone of the away team
ex. US/Pacific
hometime_zonesStringTime zone of the home team
ex. US/Eastern
venuetime_zonesStringTime zone of the venue
ex. US/Eastern
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
AttributeParent ElementTypeDescription
idseasonGUIDUnique season ID
ex. 75749c10-56c1-4ae0-9d1e-2689708debdf
nameseasonStringName of the season
typeseasonStringType of the season
yearseasonIntegerYear of the season
idweekGUIDUnique week ID
ex. 57b447ce-bc66-47f7-9760-89d328d3db9f
sequenceweekIntegerWeek sequence number
titleweekStringWeek title
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
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
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
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
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
Click Try It! to start a request and see the response here!