Rosters
This guide helps you access comprehensive information on NCAAMB rosters. You'll learn how to effectively query endpoints for real-specific team 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 Data
You 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 Roster:
{
"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 Frequency
TTL / 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, allowing them to move to a new team, often during the off-season. Mid-season transfers are possible, but players typically won’t be eligible to play for their new school until the following season, based on NCAA eligibility rules. Off-season transfers are more common, ensuring players don’t lose playing time and can maintain academic progress.
While there isn't a direct API endpoint to track transfers, the Daily Change Log feed can help you stay informed about player movements, including transfers. Player IDs remain consistent across transfers, allowing for continuous career tracking and accurate data integration into your applications.
For optimal results, set a regular schedule to pull every 10 minutes or less (depending on your use case) to access the feed.
Updated 2 months ago