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 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 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, 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. Player IDs remain consistent across transfers, supporting reliable career tracking and data integration.

Tracking Daily Transfers

While the Transfer Portal endpoint shows players who are currently in the portal, the Daily Transfers endpoint reports the individual transactions recorded for players on a given league-defined day, regardless of each transaction's effective date. Transfer portal moves make up the majority of these transactions, so this is the feed to use to confirm when a player's move to a new school is recorded; it also captures other roster changes such as activations and releases.

Each transaction returns a transaction_code and transaction_type identifying what happened. See the NCAAMB FAQ for the complete list of valid codes and types.

Use Daily Transfers to:

Identify the specific day a player's move is recorded.
Update a player's team affiliation on your platform once a transaction is official.
Power a daily transactions feed or roster-change notification without re-pulling full team rosters.

Because the endpoint is keyed to the league-defined day a transaction is created, polling it once per day captures all transactions recorded that day, regardless of when each one takes effect. The response reports the day's window in its start_time and end_time fields, and days with no transfer activity return the league and time window with no player entries.

Here is a response from a day with transfer portal commitments:

{
  "league": {
    "id": "cd4268ee-07aa-4c4d-a435-ec44ad2c76cb",
    "name": "NCAA MEN",
    "alias": "NCAAM"
  },
  "start_time": "2026-07-21T04:00:00Z",
  "end_time": "2026-07-22T03:59:59Z",
  "players": [
    {
      "id": "779289d0-9c1e-4d45-80b5-2b04cc7dfaae",
      "full_name": "Filip Brankovic",
      "first_name": "Filip",
      "last_name": "Brankovic",
      "position": "F",
      "primary_position": "NA",
      "transfers": [
        {
          "id": "0da4cf55-7eb3-44e3-95cd-94b5abddfd17",
          "desc": "F Filip Brankovic committed to High Point Panthers.",
          "effective_date": "2026-07-18",
          "last_modified": "2026-07-21T21:29:32+00:00",
          "transaction_type": "Committed",
          "transaction_code": "COM",
          "to_team": {
            "id": "a311188e-1259-4fda-b0ea-c47cb52694b1",
            "name": "Panthers",
            "market": "High Point"
          }
        }
      ]
    },
    {
      "id": "ac828779-19b3-42f9-b246-9241906d1e04",
      "full_name": "L.J. Cason",
      "first_name": "L.J.",
      "last_name": "Cason",
      "position": "G",
      "primary_position": "NA",
      "transfers": [
        {
          "id": "eda2fbf2-aa6c-47ef-8c5b-9eb0e3b49ce0",
          "desc": "G L.J. Cason committed to the Miami (FL) Hurricanes.",
          "effective_date": "2026-07-21",
          "last_modified": "2026-07-21T21:08:36+00:00",
          "transaction_type": "Committed",
          "transaction_code": "COM",
          "to_team": {
            "id": "7aec5187-cb1b-45e5-8f7d-406d766cdc73",
            "name": "Hurricanes",
            "market": "Miami (FL)"
          }
        }
      ]
    }
  ]
}

👍
Tip - Track Effective Dates
To ensure accuracy in tracking player movements, always check the effective_date in transaction data as it specifies when changes officially take place.

🔄
Pair with the Transfer Portal Endpoint
Use the Transfer Portal endpoint to monitor players who are actively in the portal, then use Daily Transfers to confirm when a move is recorded. A player's ID remains constant across both feeds, so you can follow their movement end to end.

For broader entity-level monitoring (changes to teams, players, and games), the Daily Change Log feed remains the reconciliation surface described above.