Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

League Hierarchy

UFL League Hierarchy provides top-level information for each team, including division distinction.

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

Update Frequency

TTL / Cache: 4 hours

Data Updates: Hierarchy updates appear as they are updated in the database

Recommended Pull (Non-Live): Daily

Recommended Pull (Live): Not applicable

📘

League Structure

Learn how the conference and division shells map to the standings table in UFL Fundamentals and our Tracking Standings integration scenario.


Data Points

Franchise
AttributeParent ElementTypeDescription
aliasfranchiseStringFranchise (team) alias

ex. NJ (New Jersey Generals)
idfranchiseGUIDUnique ID of a franchise

ex. ad96d260-9677-11ec-9ad0-d3ebe46bbb12
namefranchiseStringFranchise (team) name

ex. Generals
League
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league

ex. UFL
idleagueGUIDUnique ID of a league

ex. df9ab8a5-fcf3-4da4-9c49-434c148999f8
nameleagueStringName of a league

ex. UFL
aliasconferenceStringAlias of a conference

ex. UFL
idconferenceGUIDUnique ID of a conference

ex. 23f26d00-966b-11ec-aba0-0f22e7db39c9
nameconferenceStringName of a conference

ex. UFL
aliasdivisionStringAlias of a division

ex. XFL
iddivisionGUIDUnique ID of a division

ex. cf16ca01-9675-11ec-b3cb-77bc504b6aa0
namedivisionStringName of a division

ex. XFL Conference
Team
AttributeParent ElementTypeDescription
aliasteamStringTeam alias

ex. SA
championship_seasonsteamStringYears of championship seasons

ex. 2022, 2023
championships_wonteamIntegerNumber of championships won
conference_titlesteamIntegerNumber of conference titles
division_titlesteamIntegerNumber of division titles
foundedteamIntegerYear a team was founded
fight_songteamStringTeam fight song
general_managerteamStringTeam general manager

ex. Lonnie Young
idteamGUIDUnique ID of a team

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

ex. San Antonio
mascotteamStringTeam mascot

ex. Marty the Mauler
nameteamStringTeam name

ex. Brahmas
nicknamesteamStringTeam nicknames
ownerteamStringTeam owner

ex. National Spring Football League Enterprises
playoff_appearancesteamIntegerNumber of playoff appearances
presidentteamStringTeam president
sr_idteamStringUnique Sportradar ID of a team

ex. sr:competitor:882423
hex_colorteam_colorStringTeam color HEX value

ex. #ffc62f
typeteam_colorStringType of team color

primary,secondary
redteam_color - rgb-colorIntegerTeam RGB color code - Red

ex. 255
greenteam_color - rgb-colorIntegerTeam RGB color code - Green

ex. 198
blueteam_color - rgb-colorIntegerTeam RGB color code - Blue

ex. 47
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
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