⏱️
Update Frequency
TTL / Cache: 30 minutes
Data Updates: Updates in realtime as changes are made to rosters or player profiles

Data Points

League

Attribute	Parent Element	Type	Description
`alias`	`league`	String	Alias of a league ex. `NCAAM`
`id`	`league`	GUID	Unique ID of a league ex. `cd4268ee-07aa-4c4d-a435-ec44ad2c76cb`
`name`	`league`	String	Name of a league ex. `NCAA MEN`
`alias`	`conference`	String	Alias of a conference ex. `BIG10`
`id`	`conference`	GUID	Unique ID of a conference ex. `a30fe8ff-82d2-4521-bc8d-e08e6a9dbb52`
`name`	`conference`	String	Name of a conference ex. `Big Ten`
`alias`	`division`	String	Alias of a division ex. `D3`
`id`	`division`	GUID	Unique ID of a division ex. `d0196fdb-369c-4318-a318-d8e7b986ffb8`
`name`	`division`	String	Name of a division ex. `NCAA Division III`

Player

Attribute	Parent Element	Type	Description
`abbr_name`	`player`	String	Abbreviated name of a player ex. `N.Cummings`
`birth_place`	`player`	String	Birthplace of a player ex. `Midland, PA, USA`
`experience`	`player`	String	Year in school `FR`(Freshman), `SO`(Sophomore), `JR`(Junior), `SR`(Senior), `GR`(Graduate Student)
`first_name`	`player`	String	First name of a player ex. `Nelly`
`full_name`	`player`	String	Full name of a player ex. `Nelly Cummings`
`height`	`player`	unsignedByte	Height in inches
`id`	`player`	GUID	Unique player ID ex. `82643a21-c4ec-4725-b729-f4c65727c93d`
`jersey_number`	`player`	Integer	Number of a player's jersey
`last_name`	`player`	String	Last name of a player ex. `Cummings`
`position`	`player`	String	Position of a player `NA`, `C`, `C-F`, `F`, `F-C`, `F-G`, `G`, `G-F`
`primary_position`	`player`	String	Primary position of a player `NA`, `C`, `PF`, `PG`, `SF`, `SG`
`status`	`player`	String	Status of a player `ACT` (Active), `NWT` (Not with Team), `SUS`(Suspended), `DUP` (Duplicate player profile), `TP` (Transfer Portal)
`updated`	`player`	dateTime	Timestamp of a change to a player profile ex. `2025-10-21T23:30:00+00:00`
`weight`	`player`	unsignedShort	Weight in lbs.

Player Reference

Use the reference field to link a player's NCAA API profile to their NBA or G League API profile, if applicable

Attribute	Parent Element	Type	Description
`id_type`	`player` - `reference`	String	Type of a player's linked player Id ex. `league_profile` (League Player Id), `external` (NBA official `reference` Id), `sport_profile` (League-Specific API Id, synched across NBA, NCAAMB, and G League APIs)
`scope`	`player` - `reference`	String	Name of the league/API for a player's linked Id ex. `NCAAMB` (NCAA Men's Basketball API), `NBDL` (NBA G League API), `NBA` (NBA official `reference` Id), `basketball` (Player "parent" Id entry for League-Specific Sport APIs)
`source_id`	`player` - `reference`	GUID	Unique player Id for a linked player profile ex. `531fa6d3-9c8e-437b-8eca-8ca79bf12cc0` (Player Id within the NCAA Men's Basketball API or G League API), `1630545` (NBA official `reference` Id)

Team

Attribute	Parent Element	Type	Description
`alias`	`team`	String	Abbreviation of a team ex. `IOWA`
`championship_seasons`	`team`	String	Years of championship seasons ex. `1979, 2000`
`championships_won`	`team`	Integer	Number of championships won
`conference_titles`	`team`	Integer	Number of conference titles
`fight_song`	`team`	String	School fight song ex. `On Iowa!`
`founded`	`team`	Integer	Year a school was founded ex. `1847`
`id`	`team`	GUID	Unique ID of a team ex. `c10544de-e3bd-4776-ba2e-83df8c017fd1`
`market`	`team`	String	School name of a team ex. `Iowa`
`mascot`	`team`	String	Team mascot ex. `Herky the Hawk`
`name`	`team`	String	Team name ex. `Hawkeyes`
`nicknames`	`team`	String	Team nicknames
`playoff_appearances`	`team`	Integer	Number of D-I March Madness tournament appearances
`hex_color`	`team_color`	String	Team color HEX value ex. `#fcd116`
`type`	`team_color`	String	Type of team color `primary`, `secondary`
`red`	`team_color` - `rgb-color`	Integer	Team RGB color code - Red ex. `252`
`green`	`team_color` - `rgb-color`	Integer	Team RGB color code - Green ex. `209`
`blue`	`team_color` - `rgb-color`	Integer	Team RGB color code - Blue ex. `22`

Coach

Attribute	Parent Element	Type	Description
`first_name`	`coach`	String	First name of a coach ex. `Dan`
`full_name`	`coach`	String	Full name of a coach ex. `Dan Hurley`
`id`	`coach`	GUID	Unique ID of a coach ex. `1d0f4b4c-e651-43bd-abbf-24e13e762af8`
`last_name`	`coach`	String	Last name of a coach ex. `Hurley`
`position`	`coach`	String	Position of a coach ex. `Head Coach`

Venue

Attribute	Parent Element	Type	Description
`address`	`venue`	String	Address of a venue ex. `1 Elliot Drive`
`capacity`	`venue`	Integer	Capacity of a venue ex. `15500`
`city`	`venue`	String	City of a venue ex. `Iowa City`
`country`	`venue`	String	Country of a venue ex. `USA`
`id`	`venue`	GUID	Unique ID of a venue ex. `04c2567a-3a02-462b-b06b-5a4216dd30af`
`lat`	`venue` - `location`	Decimal	Latitude of a venue ex. `41.663611`
`lng`	`venue` - `location`	Decimal	Longitude of a venue ex. `-91.554444`
`name`	`venue`	String	Name of a venue ex. `Carver-Hawkeye Arena`
`state`	`venue`	String	State or province of a venue ex. `IA`
`zip`	`venue`	String	ZIP code of a venue ex. `95814`

200200