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.

⏱️

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. 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:

Attribute

Parent Element

Type

Description

alias

away

String

Away team alias
ex. MEM (Memphis)

id

away

GUID

Unique ID of the away team
ex. 51da96b0-9676-11ec-9ad0-d3ebe46bbb12

market

away

String

Away team market name
ex. New Orleans

name

away

String

Away team name
ex. Breakers

sr_id

away

String

Unique Sportradar ID of the away team
ex. sr:competitor:882413

cable

broadcast

String

Number of a game's broadcast cable station
ex. 822

internet

broadcast

String

Name of a game's internet stream
ex. ESPN+

network

broadcast

String

Name of a game's broadcast network
ex. Amazon Prime Video

radio

broadcast

String

Name of a game's radio station
ex. Sirius 134, XM 231

satellite

broadcast

String

Name of a game's broadcast satellite station
ex. ESPN Ocho

conference_game

game

Boolean

Signifies an in-Conference matchup

coverage

game

String

Optional value that displays the coverage of a game
ex. full

duration

game

String

Duration of the game
ex. 2:52

entry_mode

game

String

Type of data entry for the game
LDE (Live Data Entry)

game_type

game

String

Type of game
regular, playoff

alias

home

String

Home team alias
ex. SA

id

home

GUID

Unique ID of the home team
ex. c8797380-9677-11ec-9193-6b32ce92fd29

market

home

String

Home team market name
ex. San Antonio

name

home

String

Home team name
ex. Brahmas

sr_id

home

String

Unique Sportradar ID of the home team
ex. sr:competitor:882423

id

game

GUID

Unique ID of a game
ex. 03aa477c-de6a-4d7a-90f4-97eed05f2e89

neutral_site

game

Boolean

Signifies a game is held at a neutral site

scheduled

game

Date/Time

Scheduled date and time of a game
ex. 2022-09-25T20:10:00+00:00

sr_id

game

String

Unique Sportradar ID of a game
ex. sr:match:33623305

status

game

String

Game status
scheduled, created, inprogress, halftime, complete, closed, cancelled, delayed, suspended, postponed, time-tbd

See our UFL FAQ for game status descriptions

title

game

String

Game title
ex. UFL Championship

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

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:

Attribute

Parent Element

Type

Description

abbr_name

player

String

Abbreviated name of a player
ex. J.Crawford

age

player

Integer

Age of a player at the time of the game

birth_date

player

Date

Player date of birth
ex. 1994-12-02

birth_place

player

String

Birthplace of a player
ex. Deerfield Beach, FL, USA

college

player

String

College attended
ex. Illinois

college_conf

player

String

College Conference
ex. Big Ten Conference

first_name

player

String

First name of a player
ex. James

name

player

String

Full name of a player
ex. James Crawford

height

player

Integer

Height in inches

high_school

player

String

High school attended
ex. St. Thomas Aquinas (FL)

id

player

GUID

Unique ID of a player
ex. 94b1aa60-b862-11ec-8d8f-9baa1b88fba4

in_game_status

player

String

In-game status of a player updated in real-time
active, probable, questionable, doubtful, out, benched, unknown

jersey

player

Integer

Jersey number of a player

last_name

player

String

Last name of a player
ex. Crawford

name_suffix

player

String

Suffix of a player
ex. Jr.

position

player

String

Position of a player

See our FAQ for a list of valid positions

preferred_name

player

String

Preferred name of a player

status

player

String

Game status of a player
deactivated, dnp(Did Not Play), played, started

See our FAQ for more info on these player game statuses

weight

player

Decimal

Weight in lbs

Standings:

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
Language
Credentials
Header
Click Try It! to start a request and see the response here!