Coverage MatrixDocumentationRelease LogLog In

Game Roster

NCAAFB 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
used_challengesawayIntegerAway team challenges used
clockgameStringClock value of the game
ex. 12:37
remaining_challengeshomeIntegerHome team challenges remaining
used_challengeshomeIntegerHome team challenges used
quartergameIntegerQuarter number of the game
AttributeParent ElementTypeDescription
aliasawayStringAway team alias
ex. TCU (Texas Christian University)
idawayGUIDUnique ID of the away team
ex. a09e634d-39a8-4aa8-81a4-7337580a31f4
marketawayStringAway team market name
ex. TCU
nameawayStringAway team name
ex. Horned Frogs
conference_gamegameBooleanSignifies an in-Conference matchup
ex. (SEC vs. SEC)
coveragegameStringCoverage level of a game
full, extended_boxscore
durationgameStringDuration of a game
ex. 2:52
entry_modegameStringType of data entry for the game
LDE (Live Data Entry)
game_typegameStringType of game
regular, conference_championship, bowl, playoff
aliashomeStringHome team alias
ex. UGA (University of Georgia)
idhomeGUIDUnique ID of the home team
ex. 2eef738d-c637-4b12-b8df-4b79efcce71e
markethomeStringHome team market name
ex. Georgia
namehomeStringHome team name
ex. Bulldogs
idgameGUIDUnique ID of a game
ex. c9686716-f48a-4667-996d-97639429d8c3
neutral_sitegameBooleanSignifies a game is held at a neutral site
playoff_game_typegameStringName of a playoff game type

See our FAQ for a list of valid playoff game types
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:38354639
statusgameStringGame status
scheduled, created, inprogress, halftime, complete, closed, cancelled, postponed, delayed, suspended, flex-schedule, time-tbd

See our NCAAFB FAQ for game status descriptions
titlegameStringGame title
ex. CFP National 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
AttributeParent ElementTypeDescription
idseasonGUIDUnique season ID
ex. ff53e5e4-10ef-4842-a0b7-b489956fa07e
nameseasonStringName of the season
typeseasonStringType of the season
yearseasonIntegerYear of the season
idweekGUIDUnique week ID
ex. c5b272b0-388f-496d-ab6f-0a341b0a116b
sequenceweekIntegerWeek sequence number
titleweekStringWeek title
ex. 10
AttributeParent ElementTypeDescription
abbr_nameplayerStringAbbreviated name of a player
ex. S.Bennett
birth_placeplayerStringBirthplace of a player
ex. Blackshear, GA, USA
eiligibilityplayerStringEligibility status of a player
FR (Freshman), SO (Sophomore), JR (Junior), SR (Senior), GR (Graduate)
first_nameplayerStringFirst name of a player
ex. Stetson
heightplayerIntegerHeight in inches
idplayerGUIDUnique ID of a player
ex. 4be48c57-4b7c-46ad-8535-445c195feda6
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. Bennet
nameplayerStringFull name of a player
ex. Stetson Bennet
name_suffixplayerStringSuffix of a player
ex. Jr.
positionplayerStringPosition of a player

See our FAQ for a list of valid positions
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
first_namehome/away - coachStringFirst name of a coach
ex. Kirby
full_namehome/away - coachStringFull name of a coach
ex. Kirby Smart
idhome/away - coachGUIDUnique ID of a coach
ex. 9c34ca07-cd05-48dc-ba4e-45b9df6078eb
last_namehome/away - coachStringLast name of a coach
ex. Smart
name_suffixhome/away - coachStringSuffix of a coach
ex. Jr.
positionhome/away - coachStringType of coach
ex. Head Coach or Offensive Coordinator
AttributeParent ElementTypeDescription
aliashome/awayStringTeam alias
ex. IOW (University of Iowa)
idhome/awayGUIDUnique ID of a team
ex. a2ee495d-37c7-45ac-ac3d-d3a492a219c1
markethome/awayStringTeam market name
ex. Iowa
namehome/awayStringTeam name
ex. Hawkeyes
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue
ex. 886 Stadium Drive
capacityvenueIntegerCapacity of a venue
ex. 69250
cityvenueStringCity of a venue
ex. Iowa City
countryvenueStringCountry of a venue
ex. USA
idvenueGUIDUnique ID of a venue
ex. 967ef86b-d0de-49b7-8984-61f95104d30d
namevenueStringName of a venue
ex. Kinnick Stadium
roof_typevenueStringRoof type of a venue
outdoor, dome, retractable_dome
statevenueStringState of a venue
ex. IA
surfacevenueStringSurface type of a venue
turf, artificial, outdoor
zipvenueIntegerZIP code of a venue
ex. 52242
Click Try It! to start a request and see the response here!