Rosters
Introduction to Rosters
A college basketball roster is essentially the lineup of players registered under a team. You can access rosters using the Team Profile feed. This endpoint provides top-level team information and a full roster of active players.
Roster Updates
While rosters, team profiles, and coach information can be updated year-round, changes during the season are infrequent, so monitoring updates through the Team Profile feed is usually not necessary.
Rosters are populated starting at the end of August and continue to be updated until the college basketball season opener.
- We complete a run-through of all men's D1 teams by mid-October, with women's teams following shortly after.
- We also cover hundreds of non-D1 teams, though many of these rosters are often not finalized until the night they face a D1 team.
Accessing Rosters
- Get a team ID: You can access a list of all active teams in the NCAAMB API database with the Teams endpoint.
- Use your team ID to call the Team Profile endpoint.
Recommended Pull Frequency:
- Updates are made in real-time as changes are made to rosters or player profiles.
- Pull on an as-needed basis.
- The TTL/Cache is 300 seconds.
Tip - Utilize Team Franchise DataYou can also use the Team Roster and Team Profile endpoints to access detailed franchise data for NCAAMB teams. This information includes the team's founding year, current owner, nicknames, records of championships and division titles won and more.
Example - Team Profile:
{
"id": "bdc2561d-f603-4fab-a262-f1d2af462277",
"name": "Wolverines",
"market": "Michigan",
"alias": "MICH",
"founded": 1817,
"fight_song": "The Victors",
"championships_won": 1,
"championship_seasons": "1989",
"conference_titles": 2,
"playoff_appearances": 25,
"venue": {
"id": "64995011-8f2a-4ad8-8be8-8e60e901676b",
"name": "Crisler Center",
"capacity": 12707,
"address": "333 E Stadium Boulevard",
"city": "Ann Arbor",
"state": "MI",
"zip": "48104",
"country": "USA",
"location": {
"lat": "42.265037",
"lng": "-83.746768"
}
},
"league": {
"id": "cd4268ee-07aa-4c4d-a435-ec44ad2c76cb",
"name": "NCAA MEN",
"alias": "NCAAM"
},
"conference": {
"id": "a30fe8ff-82d2-4521-bc8d-e08e6a9dbb52",
"name": "Big Ten",
"alias": "BIG10"
},
"division": {
"id": "c5a8d640-5093-4044-851d-2c562e929994",
"name": "NCAA Division I",
"alias": "D1"
},
"coaches": [
{
"id": "5c874046-bab2-4f0e-b30a-d1dd259d7215",
"full_name": "Dusty May",
"first_name": "Dusty",
"last_name": "May",
"position": "Head Coach"
}
],
"team_colors": [
{
"type": "primary",
"hex_color": "#ffcb05",
"rgb_color": {
"red": 255,
"green": 203,
"blue": 5
}
},
{
"type": "secondary",
"hex_color": "#00274c",
"rgb_color": {
"red": 0,
"green": 39,
"blue": 76
}
}
],
"players": [
{
"id": "06facdf9-7f9c-419b-a895-1c441609e1c3",
"status": "ACT",
"full_name": "Jace Howard",
"first_name": "Jace",
"last_name": "Howard",
"abbr_name": "J.Howard",
"height": 80,
"weight": 225,
"position": "G",
"primary_position": "NA",
"jersey_number": "25",
"experience": "JR",
"birth_place": "Miami, FL, USA",
"updated": "2023-09-05T18:44:05Z"
},
{
"id": "159cf965-5a18-455e-b5c7-b19f2e1eae61",
"status": "ACT",
"full_name": "Tre Donaldson",
"first_name": "Tre",
"last_name": "Donaldson",
"abbr_name": "T.Donaldson",
"height": 75,
"weight": 200,
"position": "G",
"primary_position": "NA",
"experience": "SO",
"birth_place": "Tallahassee, FL, USA",
"updated": "2024-04-22T19:37:43Z"
},
{
"id": "1b809f2d-3461-4614-8129-2821a11f4e60",
"status": "ACT",
"full_name": "Nimari Burnett",
"first_name": "Nimari",
"last_name": "Burnett",
"abbr_name": "N.Burnett",
"height": 76,
"weight": 200,
"position": "G",
"primary_position": "NA",
"jersey_number": "4",
"experience": "GR",
"birth_place": "Chicago, IL, USA",
"updated": "2023-09-05T18:40:54Z"
},
{
"id": "2d02a64c-076e-4a60-b3a8-d5ab3df2f1d5",
"status": "ACT",
"full_name": "Jaelin Llewellyn",
"first_name": "Jaelin",
"last_name": "Llewellyn",
"abbr_name": "J.Llewellyn",
"height": 74,
"weight": 190,
"position": "G",
"primary_position": "NA",
"jersey_number": "3",
"experience": "GR",
"birth_place": "Mississauga, ON, CAN",
"updated": "2022-09-05T23:05:48Z"
},
{
"id": "34769e96-5517-4cb8-85d0-160dffa95464",
"status": "ACT",
"full_name": "Will Tschetter",
"first_name": "Will",
"last_name": "Tschetter",
"abbr_name": "W.Tschetter",
"height": 80,
"weight": 245,
"position": "F",
"primary_position": "NA",
"jersey_number": "42",
"experience": "SO",
"birth_place": "Stewartville, MN, USA",
"updated": "2023-09-05T18:45:11Z"
},
{
"id": "3707cd7a-b038-430c-bb2b-c6f5e4379ced",
"status": "ACT",
"full_name": "Danny Wolf",
"first_name": "Danny",
"last_name": "Wolf",
"abbr_name": "D.Wolf",
"height": 84,
"weight": 255,
"position": "F",
"primary_position": "NA",
"experience": "SO",
"birth_place": "Glencoe, IL, USA",
"updated": "2024-04-20T19:09:53Z"
},
{
"id": "41b9fca3-94b4-4bb4-9e5b-63ea4b1c6a53",
"status": "ACT",
"full_name": "Vladislav Goldin",
"first_name": "Vladislav",
"last_name": "Goldin",
"abbr_name": "V.Goldin",
"height": 85,
"weight": 240,
"position": "C",
"primary_position": "NA",
"experience": "JR",
"birth_place": "Nalchick,, RUS",
"updated": "2024-04-29T14:27:18Z"
},
{
"id": "5bcdb659-95b3-4010-b860-2dea41108345",
"status": "ACT",
"full_name": "Sam Walters",
"first_name": "Sam",
"last_name": "Walters",
"abbr_name": "S.Walters",
"height": 82,
"weight": 198,
"position": "F",
"primary_position": "NA",
"experience": "FR",
"birth_place": "The Villages, FL, USA",
"updated": "2024-04-22T19:32:52Z"
},
{
"id": "5f7e4bec-6119-499d-82d7-6f572b2f5e3c",
"status": "ACT",
"full_name": "Jackson Selvala",
"first_name": "Jackson",
"last_name": "Selvala",
"abbr_name": "J.Selvala",
"height": 79,
"weight": 230,
"position": "F",
"primary_position": "NA",
"jersey_number": "34",
"experience": "SR",
"birth_place": "New Canaan, CT, USA",
"updated": "2024-02-14T16:16:01Z"
},
{
"id": "72121ec9-e108-4779-8aa3-98871b5a8d80",
"status": "ACT",
"full_name": "Ian Burns",
"first_name": "Ian",
"last_name": "Burns",
"abbr_name": "I.Burns",
"height": 78,
"weight": 205,
"position": "G",
"primary_position": "NA",
"jersey_number": "14",
"experience": "JR",
"birth_place": "Winnetka, IL, USA",
"updated": "2023-09-05T18:43:21Z"
},
{
"id": "c013e1a3-65e2-43f9-be99-d03d0c35ae36",
"status": "ACT",
"full_name": "Tray Jackson",
"first_name": "Tray",
"last_name": "Jackson",
"abbr_name": "T.Jackson",
"height": 82,
"weight": 215,
"position": "F",
"primary_position": "NA",
"jersey_number": "2",
"experience": "GR",
"birth_place": "Detroit, MI, USA",
"updated": "2023-09-05T18:41:33Z"
},
{
"id": "d977c501-eb05-4567-a8ef-3a936316d7fb",
"status": "ACT",
"full_name": "Roddy Gayle Jr.",
"first_name": "Roddy",
"last_name": "Gayle",
"abbr_name": "R.Gayle",
"height": 76,
"weight": 210,
"position": "G",
"primary_position": "NA",
"experience": "SO",
"birth_place": "Niagara Falls, NY, USA",
"updated": "2024-04-22T19:34:12Z",
"name_suffix": "Jr."
},
{
"id": "deb91011-8249-4bb3-b1d4-821d9905e6a6",
"status": "ACT",
"full_name": "Harrison Hochberg",
"first_name": "Harrison",
"last_name": "Hochberg",
"abbr_name": "H.Hochberg",
"height": 79,
"weight": 225,
"position": "F",
"primary_position": "NA",
"jersey_number": "31",
"experience": "FR",
"birth_place": "New York, NY, USA",
"updated": "2023-09-05T18:46:41Z"
},
{
"id": "f21ab051-994a-4660-90b7-12e8e2a38da8",
"status": "ACT",
"full_name": "Rubin Jones",
"first_name": "Rubin",
"last_name": "Jones",
"abbr_name": "R.Jones",
"height": 77,
"weight": 190,
"position": "G",
"primary_position": "NA",
"experience": "SR",
"birth_place": "Houston, TX, USA",
"updated": "2024-04-21T02:15:31Z"
},
{
"id": "f6112a19-4e34-4c6f-bef8-9099605ef48a",
"status": "ACT",
"full_name": "Olivier Nkamhoua",
"first_name": "Olivier",
"last_name": "Nkamhoua",
"abbr_name": "O.Nkamhoua",
"height": 81,
"weight": 235,
"position": "F",
"primary_position": "NA",
"jersey_number": "13",
"experience": "GR",
"birth_place": "Helsinki,, FIN",
"updated": "2023-09-05T18:42:33Z"
},
{
"id": "f88de5ad-e7f2-477d-ab19-43724906789d",
"status": "ACT",
"full_name": "Cooper Smith",
"first_name": "Cooper",
"last_name": "Smith",
"abbr_name": "C.Smith",
"height": 73,
"weight": 180,
"position": "G",
"primary_position": "NA",
"jersey_number": "45",
"experience": "JR",
"birth_place": "Ann Arbor, MI, USA",
"updated": "2023-09-05T18:45:40Z"
}
]
}Use Cases:
If you're developing a mobile app for college basketball enthusiasts, you might want to display the active players on NCAA teams. This feature helps users make informed decisions for fantasy leagues or bracket predictions by providing real-time information on which players are currently active and eligible to participate in upcoming games.
Here’s an example of how you can display a team roster on your platform, showcasing key details like player names, jersey numbers, positions, class year, height, and weight to enhance the user experience and support in-depth team analysis.
Daily Change Log
The Daily Change Log endpoint provides an efficient way to monitor any roster adjustments within the NCAAMB API prior to the season starting.
The table below outlines scenarios and use cases for utilizing the Daily Change Log based on team roster and player updates.
Steps to monitor roster updates:
-
Identify Change Types: First, review the Daily Change Log to identify the types of changes reported. These could be related to games, players, or teams. Each entry in the log will list relevant IDs (game, player, or team ID), depending on the type of change.
-
Use IDs to Retrieve Specifics: IDs associated with players or teams indicate changes relevant to these entities, such as updates to team rosters.
-
Pull Detailed Data: Use the identified IDs to pull detailed information from the Team Profile feed.
-
Verify Changes: After pulling the data, compare the newly retrieved data against previously stored data to verify the changes and update your records accordingly.
Update FrequencyTTL / Cache: 300 seconds
Data Updates:
- Entries populate live for changes to teams, players, game statistics, schedules, and standings.
- Start time of the log is 05:00:00 UTC; end time is 04:59:59 UTC
Transferring Schools
In NCAA Basketball, players can switch schools by entering the NCAA transfer portal, typically during the off-season. Mid-season transfers are allowed but usually result in delayed eligibility based on NCAA rules.
To track players who have entered the transfer process, refer to the Transfer Portal endpoint, which provides a list of active portal players.
For confirmed team changes and broader player movement, use the Daily Change Log feed. Player IDs remain consistent across transfers, supporting reliable career tracking and data integration.
Updated 14 days ago