Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Game Roster

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache:

  • 60 seconds when a game is in scheduled status
  • 3 seconds when a game moves to inprogress
  • 600 seconds when a game moves to closed
  • 4 hours when seven days have passed since closed

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. Larry Smith
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. PHI (Philadelphia)
iddraft - teamGUIDUnique ID of a draft team

ex. b786eb70-9677-11ec-9193-6b32ce92fd29
marketdraft - teamStringDraft team market name

ex. Philadelphia
namedraft - teamStringDraft team name

ex. Stars
sr_iddraft - teamStringUnique Sportradar ID of a draft team

ex. sr:competitor:882421
Game
AttributeParent ElementTypeDescription
aliasawayStringAway team alias

ex. MEM (Memphis)
idawayGUIDUnique ID of the away team

ex. 51da96b0-9676-11ec-9ad0-d3ebe46bbb12
marketawayStringAway team market name

ex. New Orleans
nameawayStringAway team name

ex. Breakers
sr_idawayStringUnique Sportradar ID of the away team

ex. sr:competitor:882413
cablebroadcastStringNumber of a game's broadcast cable station

ex. 822
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
coveragegameStringOptional value that displays the coverage of a game

ex. full
deletedgameBooleanSignifies a game was deleted when true
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. SA
idhomeGUIDUnique ID of the home team

ex. c8797380-9677-11ec-9193-6b32ce92fd29
markethomeStringHome team market name

ex. San Antonio
namehomeStringHome team name

ex. Brahmas
sr_idhomeStringUnique Sportradar ID of the home team

ex. sr:competitor:882423
idgameGUIDUnique ID of a game

ex. 03aa477c-de6a-4d7a-90f4-97eed05f2e89
neutral_sitegameBooleanSignifies a game is held at a neutral site
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, halftime, complete, closed, cancelled, delayed, suspended, postponed, time-tbd

See our UFL FAQ for game status descriptions
titlegameStringGame title

ex. UFL 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
League
AttributeParent ElementTypeDescription
idseasonGUIDUnique season ID

ex. 234f28d6-b9d7-4881-a890-30b451c13aec
nameseasonStringName of the season

PRE, REG, PST
typeseasonStringType of the season

PRE, REG, PST
yearseasonIntegerYear of the season
idweekGUIDUnique week ID

ex. eb5f5b92-6a4e-42a7-b590-3f0ce7cc4736
sequenceweekIntegerWeek sequence number
titleweekStringWeek title
Player
AttributeParent ElementTypeDescription
abbr_nameplayerStringAbbreviated name of a player

ex. J.Crawford
ageplayerIntegerAge of a player at the time of the game
birth_dateplayerDatePlayer date of birth

ex. 1994-12-02
birth_placeplayerStringBirthplace of a player

ex. Deerfield Beach, FL, USA
collegeplayerStringCollege attended

ex. Illinois
college_confplayerStringCollege Conference

ex. Big Ten Conference
first_nameplayerStringFirst name of a player

ex. James
nameplayerStringFull name of a player

ex. James Crawford
heightplayerIntegerHeight in inches
high_schoolplayerStringHigh school attended

ex. St. Thomas Aquinas (FL)
idplayerGUIDUnique ID of a player

ex. 94b1aa60-b862-11ec-8d8f-9baa1b88fba4
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. Crawford
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
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
Team Records

Team win-loss-tie data is added after a game moves to complete status. It is not present prior to or during a game.

AttributeParent ElementTypeDescription
lossesrecordIntegerNumber of team losses year-to-date after a game
tiesrecordIntegerNumber of team ties year-to-date after a game
winsrecordIntegerNumber of team wins year-to-date after a game
Coaches
AttributeParent ElementTypeDescription
first_namehome/away - coachStringFirst name of a coach

ex. John
full_namehome/away - coachStringFull name of a coach

ex. John DeFilippo
idhome/away - coachGUIDUnique ID of a coach

ex. 80675d40-6102-11ed-a6fd-cb7b3f097b25
last_namehome/away - coachStringLast name of a coach

ex. DeFilippo
name_suffixhome/away - coachStringSuffix of a coach

ex. Jr.
positionhome/away - coachStringType of coach

ex. Head Coach
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
addressvenueStringAddress of a venue

ex. 1020 24th St N
capacityvenueIntegerCapacity of a venue

ex. 47100
cityvenueStringCity of a venue

ex. Birmingham
countryvenueStringCountry of a venue

ex. USA
idvenueGUIDUnique 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
namevenueStringName of a venue

ex. Protective Stadium
roof_typevenueStringRoof type of a venue

outdoor, dome, retractable_dome
sr_idvenueStringUnique Sportradar venue ID

ex. sr:venue:58724
statevenueStringState of a venue

ex. AL
surfacevenueStringSurface type of a venue

turf, artificial
zipvenueIntegerZIP code of a venue

ex. 35203

Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

en (English)

Allowed:
string
required
Defaults to 0dce9d15-e969-4755-8a71-66e98b3786cd

Unique Id of a game, found in a Schedule endpoint.

Example: 0dce9d15-e969-4755-8a71-66e98b3786cd

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json