Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Team Profile

Unrivaled Teams Profile provides top-level team information and a full roster of active players.

⏱️

Update Frequency

TTL / Cache: 300 seconds

Data Updates: Updates in realtime as changes are made to rosters or player profiles


Data Points

League
AttributeParent ElementTypeDescription
aliashierarchy - leagueStringAlias of a league

ex. UNRIVALED
idhierarchy - leagueGUIDUnique ID of a league

ex. 844ee10a-00c8-4dc1-9c17-52598de2ef47
namehierarchy - leagueStringName of a league

ex. Unrivaled
aliashierarchy - conferenceStringAlias of a conference

ex. UNRIVALED
idhierarchy - conferenceGUIDUnique ID of a conference

ex. 56089804-dbb3-4621-96eb-ec520ab26988
namehierarchy - conferenceStringName of a conference

ex. Unrivaled
Player
AttributeParent ElementTypeDescription
abbr_nameplayerStringAbbreviated name of a player

ex. N.Collier
birthdateplayerDatePlayer date of birth

ex. 1995-09-17
birth_placeplayerStringBirthplace of a player

ex. St. Louis, MO, USA
collegeplayerStringCollege attended

ex. UConn
experienceplayerunsignedByteNumber of years played in Unrivaled
first_nameplayerStringFirst name of a player

ex. Napheesa
full_nameplayerStringFull name of a player

ex. Napheesa Collier
heightplayerunsignedByteHeight in inches
high_schoolplayerStringHigh school attended

ex. Incarnate Word Academy (MO)
idplayerGUIDUnique player ID

ex. e2992444-14b7-4cc1-9880-a874e676d7fd
jersey_numberplayerIntegerNumber of a player's jersey
last_nameplayerStringLast name of a player

ex. Collier
positionplayerStringPosition of a player

NA, C, C-F, F, F-C, F-G, G, G-F
primary_positionplayerStringPrimary position of a player

NA, C, PF, PG, SF, SG
statusplayerStringStatus of a player

ACT (Active), SUS (Suspended), IR (Injured Reserve), NWT (Not with Team), FA (Free Agent), RET (Retired), DUP (Duplicate Player Profile)
updatedplayerdateTimeTimestamp of a change to a player profile

ex. 2022-09-30T22:55:57Z
weightplayerunsignedShortWeight in lbs.
Player Reference

Use the reference field to link a player's Unrivaled API profile to their WNBA API or NCAA Women's Basketball API profile

AttributeParent ElementTypeDescription
id_typeplayer - referenceStringType of a player's linked player Id

ex. league_profile (League Player Id), sport_profile (League-Specific API Id, synched across Unrivaled, WNBA and NCAAWB APIs)
scopeplayer - referenceStringName of the league/API for a player's linked Id

ex. NCAAW (NCAA Women's Basketball API), WNBA (WNBA API), basketball (Player "parent" Id entry for League-Specific Sport APIs)
source_idplayer - referenceGUIDUnique player Id for a linked player profile

ex. ea798cfb-8765-4246-a428-3d451c9a935d (Player Id within the NCAA Women's Basketball API)
Injuries
AttributeParent ElementTypeDescription
commentplayer - injuries - injuryStringText description of an injury

ex. Powers is listed as out with an ankle injury, no timetable on return.
descinjuryStringBrief description of an injury

ex. Illness or Knee
idinjuryGUIDUnique ID of an injury

ex. 126185b5-4e27-454c-b0a3-57a6ac768d11
start_dateinjuryDateDate an injury transaction goes into effect

ex. 2023-06-16
statusinjuryStringStatus of an injury

Unknown, Day To Day, Out, Out for Season, Out Indefinitely
update_datetransactionDateDate of an injury update

ex. 2023-06-26
Team
AttributeParent ElementTypeDescription
aliasteamStringAbbreviation of a team

ex. LNR (Lunar Owls)
championship_seasonsteamStringYears of championship seasons

ex. 2025
championships_wonteamIntegerNumber of championships won
foundedteamIntegerYear team was founded

ex. 2025
idteamGUIDUnique ID of a team

ex. 67c22115-2385-458f-8632-a67a025fef55
marketteamStringMarket name of a team.

Not typically used for Unrivaled
nameteamStringTeam name

ex. Lunar Owls
hex_colorteam_colorStringTeam color HEX value

ex. #0c233f
typeteam_colorStringType of team color

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

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

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

ex. 63
Coach
AttributeParent ElementTypeDescription
first_namecoachStringFirst name of a coach

ex. DJ
full_namecoachStringFull name of a coach

ex. DJ Sackmann
idcoachGUIDUnique ID of a coach

ex. 6fe2b3cc-2aeb-4929-a3b3-b68e84f9b9bf
last_namecoachStringLast name of a coach

ex. Sackmann
positioncoachStringPosition of a coach

ex. Head Coach or Assistant Coach
Venue
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue

ex. 7321 NW 75th Street
capacityvenueStringCapacity of a venue

ex. 850
cityvenueStringCity of a venue

ex. Medley
countryvenueStringCountry of a venue

ex. USA
idvenueGUIDUnique ID of a venue

ex. 67e49419-cb04-4ce0-ab33-ae42af8d8634
latvenue - locationDecimalLatitude of a venue

ex. 25.842035
lngvenue - locationDecimalLongitude of a venue

ex. -80.317192
namevenueStringName of a venue

ex. Wayfair Arena
statevenueStringState or province of a venue

ex. FL
zipvenueIntegerZIP code of a venue

ex. 33166
Language
Credentials
Header
Click Try It! to start a request and see the response here!