Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

ID Handling

Intro to IDs

Our NCAA Men's Basketball (NCAAMB) API features a number of unique identifiers. Some IDs are needed to request feeds, while others signify unique data.

IDs can be attributed to leagues, conferences, divisions, teams, venues, quarters, coaches, plays, in-game events, and many other variables.



ID Types

UUIDs (Universally Unique Identifiers) serve as the primary ID types used to represent a wide range of variables. These IDs uniquely identify a specific variable within the API and are consistent across multiple Sportradar APIs or even external data sources.

UUIDs follow a specific structure: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

You'll see these UUIDs for teams, players, games, seasons, and more.

<team id="8ddbfca9-a931-4908-aa31-9fcd17624b5f" name="49ers" alias="CHAR" market="Charlotte"/>



IDs in other SR Products


NBA

Many NCAA Men's Basketball players go on to play in the NBA, and thus have profiles and IDs within the NBA API. However, their unique college basketball IDs do not transfer to the NBA API.

Drafted players are added to their NBA teams within a few days after the NBA Draft. Any undrafted free agents will also be added when those signings are announced. All of these player IDs will be separate across APIs.

NCAA API player IDs will be present in the NBA Draft feeds under the source_id. This can be used to link profiles across systems if necessary.

<prospect id="782bf72e-ba49-40d3-b8ed-10b365fcf4de" source_id="c2c42723-cc6c-420e-8202-070a4023c6ff" league_id="ddee4a31-2791-4339-bfc3-a058ce2d1397" first_name="Stephon" last_name="Castle" name="Stephon Castle" position="G" height="78" weight="215" experience="FR" birth_place="Covington, GA, USA"/>

For any player absent from the Draft feeds, the method of linking their profile from the NBA API is to utilize bio information, such as their name, college, and position.


NBA G League

Player IDs from the NCAAMB API are not synced to the NBA G League API. However, Sportradar IDs will be consistent across sports and leagues, where available.


Global Basketball

The Global Basketball API covers NCAAMB data at a much lower tier, and is based on the sr_id system, with IDs that look like: sr:competitor:3420 or sr:sport_event:53286421.

Make use of the Mapping Feeds within Global Basketball should you need to link between APIs. These feeds provide id and sr_id links for teams, players, games, and seasons.

<mapping external_id="8ddbfca9-a931-4908-aa31-9fcd17624b5f" id="sr:competitor:87824"/>
<mapping external_id="73399a24-e05f-4d0f-bc99-f633324a31eb" id="sr:competitor:302228"/>
<mapping external_id="cb52cdfb-23b9-4fed-bbe8-f8df05821973" id="sr:competitor:297678"/>
<mapping external_id="de1e599a-32df-4e8c-916f-9ac20912009c" id="sr:competitor:297656"/>
<mapping external_id="8709616c-fb1c-4210-bd0c-ec4bd68fd69f" id="sr:competitor:305430"/>
<mapping external_id="7a30c43d-a206-476d-b5b2-75b419445ae9" id="sr:player:1176252"/>
<mapping external_id="20690402-3651-4ad5-8637-2cb1081bbb06" id="sr:player:2859809"/>
<mapping external_id="4d98d238-6a96-4770-ac25-3cec68b4f90c" id="sr:player:2859775"/>
<mapping external_id="01990f34-37fa-40c5-83ae-bd4da18a6901" id="sr:player:2859773"/>
<mapping external_id="2ee308da-2d15-42af-9e0d-7a4b211d07dd" id="sr:player:2859771"/>
<mapping external_id="e6d5aefa-59ef-49af-8fc2-bc27dc07ca99" id="sr:sport_event:53286421"/>
<mapping external_id="fdfc9371-22d3-4c8e-b95c-50b847a29505" id="sr:sport_event:53286415"/>
<mapping external_id="c12abfc2-ea49-49ad-a8bf-a26abed68c27" id="sr:sport_event:53336599"/>
<mapping external_id="35d392a6-d9b6-4225-97dd-c6e72b47c0d9" id="sr:sport_event:52864745"/>
<mapping external_id="8cbdc7e2-f9cb-4b89-92a4-05bcd57169d6" id="sr:sport_event:52866623"/>
<mapping external_id="a871223e-1e70-419e-8697-c0c1c010a7a9" id="sr:season:105257"/>
<mapping external_id="3dcf4c11-e7f8-4996-a34d-49069d14d465" id="sr:season:104315"/>
<mapping external_id="6d242a1f-93d0-48e4-96c0-45ff92ba607e" id="sr:season:105255"/>
<mapping external_id="7aa53f56-bde6-441f-966b-161ecd993de5" id="sr:season:104319"/>
<mapping external_id="db004e22-7ed4-4316-8302-79454224f49d" id="sr:season:112470"/>

🗝️

Access

Please note that you will need access to the Global Basketball API in your account to make use of these endpoints.


Images & Editorial

Our Images and Editorial APIs include both UUID and SR IDs within image and article entries (under entity_id). This allows you to sync player, team, and game IDs to this content.

<asset id="c5cdb914-7c8b-4021-90f6-580c7c896759" created="2023-01-04T04:30:09+00:00" updated="2023-01-04T04:30:21+00:00" player_id="d41e0490-346c-4e78-a679-a4ac44ade1cf" posed="false">
    <title>
      <![CDATA[Baylor Scheierman]]>
    </title>
    <description>
      <![CDATA[Baylor Scheierman]]>
    </description>
    <copyright>USA Today Sports Images</copyright>
    <links>
      <link width="1200" height="1200" href="/headshots/players/c5cdb914-7c8b-4021-90f6-580c7c896759/original.jpg"/>
      <link width="250" height="250" href="/headshots/players/c5cdb914-7c8b-4021-90f6-580c7c896759/250w-resize.jpg"/>
    </links>
    <refs>
      <ref name="Scheierman, Baylor" type="profile" sport="ncaamb" sportradar_id="d41e0490-346c-4e78-a679-a4ac44ade1cf" primary="true">
        <entity_id origin="SD" id="d41e0490-346c-4e78-a679-a4ac44ade1cf" sport="ncaamb"/>
      </ref>
      <ref name="Creighton Bluejays" type="organization" sport="ncaamb" sportradar_id="7d797407-623e-476d-b299-46de4275414d">
        <entity_id origin="SD" id="7d797407-623e-476d-b299-46de4275414d" sport="ncaamb"/>
      </ref>
    </refs>
    <provider name="usat">
      <provider_item_id>19717415</provider_item_id>
      <original_publish>2023-01-03T15:13:42+00:00</original_publish>
    </provider>
  </asset>

Widgets

Our NCAA Men's Basketball Widgets often will require the input of a unique game, team, player, or season ID. Each of these are the UUIDs found in the NCAAMB API.



Game IDs

Each NCAAMB game will have its own unique identifier under game.id. See below for a sample taken from the Schedule endpoint.

<game id="671ac3a3-269a-4390-ac04-89b8bc731445" status="closed" coverage="full" scheduled="2023-11-06T23:30:00Z" home_points="95" away_points="52" conference_game="false" track_on_court="true" home_team="efba5350-79bc-47aa-a189-db177b95b491" away_team="1753768d-e46e-40b1-8d69-a8ae5cccec03">
	<time_zones venue="US/Eastern" home="US/Eastern" away="US/Mountain"/>
	<venue id="0d1fc5bc-9f37-4f19-af35-c081088ae93d" name="Harry A. Gampel Pavilion" capacity="10167" address="2095 Hillside Road" city="Storrs" state="CT" zip="06268" country="USA">
		<location lat="41.805292" lng="-72.254194"/>
	</venue>
	<home name="UConn Huskies" alias="CONN" id="efba5350-79bc-47aa-a189-db177b95b491"></home>
	<away name="Northern Arizona Lumberjacks" alias="NAU" id="1753768d-e46e-40b1-8d69-a8ae5cccec03"></away>
	<broadcasts>
		<broadcast network="Fox Sports 1" type="TV" locale="National" channel="219"/>
	</broadcasts>
</game>
{
  "id": "671ac3a3-269a-4390-ac04-89b8bc731445",
  "status": "closed",
  "coverage": "full",
  "scheduled": "2023-11-06T23:30:00Z",
  "home_points": 95,
  "away_points": 52,
  "conference_game": false,
  "track_on_court": true,
  "time_zones": {
    "venue": "US/Eastern",
    "home": "US/Eastern",
    "away": "US/Mountain"
  },
  "venue": {
    "id": "0d1fc5bc-9f37-4f19-af35-c081088ae93d",
    "name": "Harry A. Gampel Pavilion",
    "capacity": 10167,
    "address": "2095 Hillside Road",
    "city": "Storrs",
    "state": "CT",
    "zip": "06268",
    "country": "USA",
    "location": {
      "lat": "41.805292",
      "lng": "-72.254194"
    }
  },
  "broadcasts": [
    {
      "network": "Fox Sports 1",
      "type": "TV",
      "locale": "National",
      "channel": "219"
    }
  ],
  "home": {
    "name": "UConn Huskies",
    "alias": "CONN",
    "id": "efba5350-79bc-47aa-a189-db177b95b491"
  },
  "away": {
    "name": "Northern Arizona Lumberjacks",
    "alias": "NAU",
    "id": "1753768d-e46e-40b1-8d69-a8ae5cccec03"
  }
}

Once created, game IDs are unchanging, except in the rare case that a game is postponed, or a game is mistakenly created twice (the duplicated UUID would be removed).



Team IDs

Each NCAAMB team will have its own unique identifier under team.id. You can locate all active teams in the League Hierarchy feed, and all active teams in our NCAAMB database in the Teams feed.

<team id="52f29fae-29af-46ec-9882-5b731ac91515" name="Aggies" alias="CAMU" market="Cameron"/>
<team id="8aaad1c0-d16e-4b9f-8541-dac670addd71" name="Aggies" alias="UCD" market="UC Davis"/>
<team id="5016fe1a-9571-4d10-bf5b-b9c1b496bd57" name="Aggies" alias="NMSU" market="New Mexico State"/>
{
  "id": "2853cf4d-6d62-4ec6-8e2c-d69f7a01a557",
  "name": "Big 12",
  "alias": "BIG12",
  "teams": [
    {
      "id": "054c3e85-0552-4549-b123-7e84af6e7b6c",
      "name": "Knights",
      "market": "UCF",
      "alias": "UCF",
      "founded": 1963,
      "mascot": "Knightro",
      "fight_song": "Charge On",
      "championships_won": 0,
      "conference_titles": 4,
      "playoff_appearances": 5,
      "team_colors": [
        {
          "type": "primary",
          "hex_color": "#000000",
          "rgb_color": {
            "red": 0,
            "green": 0,
            "blue": 0
          }
        },
        {
          "type": "secondary",
          "hex_color": "#b7a369",
          "rgb_color": {
            "red": 183,
            "green": 163,
            "blue": 105
          }
        }
      ],
      "venue": {
        "id": "c76914a3-7d54-4d6e-be85-cd6ccc69da47",
        "name": "Addition Financial Arena",
        "capacity": 9465,
        "address": "12777 Gemini Boulevard N",
        "city": "Orlando",
        "state": "FL",
        "zip": "32816",
        "country": "USA",
        "location": {
          "lat": "28.607225",
          "lng": "-81.1973669"
        }
      }
    },
    {
      "id": "0d037a5d-827a-44dd-8b70-57603d671d5d",
      "name": "Utes",
      "market": "Utah",
      "alias": "UTAH",
      "founded": 1850,
      "mascot": "Swoop",
      "fight_song": "Utah Man",
      "championships_won": 1,
      "championship_seasons": "1944",
      "conference_titles": 5,
      "playoff_appearances": 29,
      "team_colors": [
        {
          "type": "secondary",
          "hex_color": "#ffffff",
          "rgb_color": {
            "red": 255,
            "green": 255,
            "blue": 255
          }
        },
        {
          "type": "primary",
          "hex_color": "#cc0000",
          "rgb_color": {
            "red": 204,
            "green": 0,
            "blue": 0
          }
        }
      ],
      "venue": {
        "id": "c06cdbce-91ba-4306-b31c-97df5cbf2515",
        "name": "Jon M. Huntsman Center",
        "capacity": 15000,
        "address": "1825 East South Campus Drive",
        "city": "Salt Lake City",
        "state": "UT",
        "zip": "84112",
        "country": "USA",
        "location": {
          "lat": "40.762",
          "lng": "-111.839"
        }
      }
    },
    {
      "id": "0e4258fa-3154-4c16-b693-adecab184c6c",
      "name": "Cyclones",
      "market": "Iowa State",
      "alias": "ISU",
      "founded": 1858,
      "mascot": "Cy the Cardinal",
      "fight_song": "ISU Fights",
      "championships_won": 0,
      "conference_titles": 7,
      "playoff_appearances": 23,
      "team_colors": [
        {
          "type": "secondary",
          "hex_color": "#fdca2f",
          "rgb_color": {
            "red": 253,
            "green": 202,
            "blue": 47
          }
        },
        {
          "type": "primary",
          "hex_color": "#822433",
          "rgb_color": {
            "red": 130,
            "green": 36,
            "blue": 51
          }
        }
      ],
      "venue": {
        "id": "5fa4e0d6-a1e9-4ddc-803d-e75916afa21a",
        "name": "James H. Hilton Coliseum",
        "capacity": 14384,
        "address": "1700 Center Drive",
        "city": "Ames",
        "state": "IA",
        "zip": "50010",
        "country": "USA",
        "location": {
          "lat": "42.02101",
          "lng": "-93.634763"
        }
      }
    }
  ]
}

TBD Teams

Within the Teams feed, you will find a TBD team. This unique ID can be used to populate game information when game matchups are not yet known. You can find more info on this process in the March Madness integration scenario.

<team id="24f0e2b9-1f65-43f0-81e6-18dd3b8f88ae" name="TBD" market="Team" alias="TBD"/>



Player IDs

Each NCAAMB player will have their own unique identifier under player.id. You can locate all active players on a given team in the Team Profile endpoint, and retrieve detailed player biographical info and stats in the Player Profile endpoint.

Player IDs will not change once created.

<team xmlns="http://feed.elasticstats.com/schema/basketball/team-v8.0.xsd" id="c10544de-e3bd-4776-ba2e-83df8c017fd1" name="Hawkeyes" market="Iowa" alias="IOWA" founded="1847" mascot="Herky the Hawk" fight_song="On Iowa!" championships_won="0" conference_titles="3" playoff_appearances="29">
  <venue id="04c2567a-3a02-462b-b06b-5a4216dd30af" name="Carver-Hawkeye Arena" capacity="15500" address="1 Elliot Drive" city="Iowa City" state="IA" zip="52242" country="USA">
    <location lat="41.663611" lng="-91.554444"/>
  </venue>
  <hierarchy>
    <league id="cd4268ee-07aa-4c4d-a435-ec44ad2c76cb" name="NCAA MEN" alias="NCAAM"/>
    <division id="c5a8d640-5093-4044-851d-2c562e929994" name="NCAA Division I" alias="D1"/>
    <conference id="a30fe8ff-82d2-4521-bc8d-e08e6a9dbb52" name="Big Ten" alias="BIG10"/>
  </hierarchy>
  <coaches>
    <coach id="114a82d1-7935-4222-9711-b3a5c6e2dfe2" full_name="Fran McCaffery" first_name="Fran" last_name="McCaffery" position="Head Coach"/>
  </coaches>
  <team_colors>
    <team_color type="primary" hex_color="#000000">
      <rgb_color red="0" green="0" blue="0"/>
    </team_color>
    <team_color type="secondary" hex_color="#fcd116">
      <rgb_color red="252" green="209" blue="22"/>
    </team_color>
  </team_colors>
  <players>
    <player id="1b2259c6-01d3-4fe8-8b7c-359a222b6d4c" status="ACT" full_name="Brock Harding" first_name="Brock" last_name="Harding" abbr_name="B.Harding" height="72" weight="162" position="G" primary_position="NA" jersey_number="2" experience="SO" birth_place="Moline, IL, USA" updated="2024-07-15T15:02:44Z">
    </player>
    <player id="1e96f6be-4f1c-43d5-a63c-62cb4eb7961b" status="ACT" full_name="Jovone Cater" first_name="Jovone" last_name="Cater" abbr_name="J.Cater" height="74" weight="180" position="G" primary_position="NA" jersey_number="10" experience="SR" birth_place="Far Rockaway, NY, USA" updated="2023-11-08T00:51:21Z">
    </player>
    <player id="2656cdcd-bb3b-4bd0-a825-5d3c23eab952" status="ACT" full_name="Carter Kingsbury" first_name="Carter" last_name="Kingsbury" abbr_name="C.Kingsbury" height="76" weight="225" position="G" primary_position="NA" jersey_number="14" experience="JR" birth_place="Ponca, NE, USA" updated="2024-07-15T15:05:47Z">
    </player>
    <player id="373a92fd-9f8c-441c-a157-364a85211db6" status="ACT" full_name="Trey Buchanan" first_name="Trey" last_name="Buchanan" abbr_name="T.Buchanan" height="73" weight="175" position="G" primary_position="NA" jersey_number="5" experience="FR" birth_place="Westfield, IN" updated="2024-07-15T15:03:57Z">
    </player>
    <player id="3d3fb476-1b45-41f2-a901-2b1d6c87fa83" status="ACT" full_name="Josh Dix" first_name="Josh" last_name="Dix" abbr_name="J.Dix" height="77" weight="200" position="G" primary_position="NA" jersey_number="4" experience="JR" birth_place="Council Bluffs, IA, USA" updated="2024-07-15T15:03:12Z">
    </player>
    <player id="4c4c82dc-e856-4029-964e-b59c2feb695f" status="ACT" full_name="Chris Tadjo" first_name="Chris" last_name="Tadjo" abbr_name="C.Tadjo" height="80" weight="220" position="F" primary_position="NA" jersey_number="34" experience="FR" birth_place="Montreal, QC, CAN" updated="2024-07-15T15:07:09Z">
    </player>
    <player id="50f0fc91-0aac-4a7d-9dc3-7eb4a3839d5b" status="ACT" full_name="Riley Mulvey" first_name="Riley" last_name="Mulvey" abbr_name="R.Mulvey" height="82" weight="230" position="F" primary_position="NA" jersey_number="44" experience="JR" birth_place="Rotterdam, NY, USA" updated="2024-07-15T15:06:44Z">
    </player>
    <player id="54d34288-7605-441b-b325-a39d62618823" status="ACT" full_name="Seydou Traore" first_name="Seydou" last_name="Traore" abbr_name="S.Traore" height="79" weight="215" position="F" primary_position="NA" jersey_number="7" experience="SO" birth_place="New York, NY, USA" updated="2024-07-15T15:04:22Z">
    </player>
    <player id="5cb2ef6d-33ae-453b-8379-80958febca60" status="ACT" full_name="Pryce Sandfort" first_name="Pryce" last_name="Sandfort" abbr_name="P.Sandfort" height="78" weight="205" position="F" primary_position="NA" jersey_number="24" experience="SO" birth_place="Waukee, IA, USA" updated="2024-07-15T15:06:11Z">
    </player>
    <player id="633bb101-df4d-4835-9db5-f66b94615352" status="ACT" full_name="Ladji Dembele" first_name="Ladji" last_name="Dembele" abbr_name="L.Dembele" height="80" weight="250" position="F" primary_position="NA" jersey_number="13" experience="SO" birth_place="Newark, NJ, USA" updated="2024-07-15T15:05:40Z">
    </player>
    <player id="7827ae65-3b01-45ba-9de6-f6ffb2712d43" status="ACT" full_name="Cooper Koch" first_name="Cooper" last_name="Koch" abbr_name="C.Koch" height="80" weight="205" position="F" primary_position="NA" jersey_number="8" experience="FR" birth_place="Peoria, IL, USA" updated="2024-07-15T15:04:53Z">
    </player>
    <player id="7d39d2b4-b73a-43f4-ab2d-1e3db4fc137a" status="ACT" full_name="Luc Laketa" first_name="Luc" last_name="Laketa" abbr_name="L.Laketa" height="77" weight="185" position="G" primary_position="NA" jersey_number="25" experience="SR" birth_place="Concord, MI, USA" updated="2024-07-15T15:06:19Z">
    </player>
    <player id="8c87f9ee-6afd-408d-83c4-8fa8b7831992" status="ACT" full_name="Even Brauns" first_name="Even" last_name="Brauns" abbr_name="E.Brauns" height="81" weight="245" position="F" primary_position="NA" jersey_number="0" experience="GR" birth_place="Iowa City, IA, USA" updated="2024-07-15T15:01:15Z">
    </player>
    <player id="a4626869-5e84-4576-8066-c5b9fe37fd2e" status="ACT" full_name="Jacob Koch" first_name="Jacob" last_name="Koch" abbr_name="J.Koch" height="74" weight="175" position="G" primary_position="NA" jersey_number="10" experience="FR" birth_place="Iowa City, IA, USA" updated="2024-07-15T15:05:26Z">
    </player>
    <player id="c643f3a1-52df-4046-9ee0-351ffa7fc887" status="ACT" full_name="Payton Sandfort" first_name="Payton" last_name="Sandfort" abbr_name="P.Sandfort" height="79" weight="215" position="F" primary_position="NA" jersey_number="20" experience="SR" birth_place="Waukee, IA, USA" updated="2024-07-15T15:05:58Z">
    </player>
    <player id="d0a0622e-1deb-48fc-bc83-e07d603e8e73" status="ACT" full_name="Drew Thelwell" first_name="Drew" last_name="Thelwell" abbr_name="D.Thelwell" height="75" weight="195" position="G" primary_position="NA" jersey_number="3" experience="GR" birth_place="Orlando, FL, USA" updated="2024-07-15T15:02:56Z">
    </player>
    <player id="d1a4ccfb-773b-4642-9a45-4e6cc57586cb" status="ACT" full_name="Owen Freeman" first_name="Owen" last_name="Freeman" abbr_name="O.Freeman" height="82" weight="230" position="F" primary_position="NA" jersey_number="32" experience="SO" birth_place="Moline, IL, USA" updated="2024-07-15T15:06:26Z">
    </player>
{
  "id": "1b2259c6-01d3-4fe8-8b7c-359a222b6d4c",
  "status": "ACT",
  "full_name": "Brock Harding",
  "first_name": "Brock",
  "last_name": "Harding",
  "abbr_name": "B.Harding",
  "height": 72,
  "weight": 162,
  "position": "G",
  "primary_position": "NA",
  "jersey_number": "2",
  "experience": "SO",
  "birth_place": "Moline, IL, USA",
  "updated": "2024-07-15T15:02:44Z",
  "league": {
    "id": "cd4268ee-07aa-4c4d-a435-ec44ad2c76cb",
    "name": "NCAA MEN",
    "alias": "NCAAM"
  },
  "team": {
    "id": "c10544de-e3bd-4776-ba2e-83df8c017fd1",
    "name": "Hawkeyes",
    "market": "Iowa",
    "alias": "IOWA"
  },
  "seasons": [
    {
      "id": "05b9e2ec-8916-432f-8a56-6579eb825dd0",
      "year": 2023,
      "type": "REG",
      "teams": [
        {
          "id": "c10544de-e3bd-4776-ba2e-83df8c017fd1",
          "name": "Hawkeyes",
          "market": "Iowa",
          "alias": "IOWA",
          "total": {
            "games_played": 34,
            "games_started": 0,
            "minutes": 368,
            "field_goals_made": 42,
            "field_goals_att": 116,
            "field_goals_pct": 0.362,
            "two_points_made": 27,
            "two_points_att": 76,
            "two_points_pct": 0.355,
            "three_points_made": 15,
            "three_points_att": 40,
            "three_points_pct": 0.375,
            "blocked_att": 5,
            "free_throws_made": 17,
            "free_throws_att": 22,
            "free_throws_pct": 0.773,
            "offensive_rebounds": 1,
            "defensive_rebounds": 18,
            "rebounds": 19,
            "assists": 89,
            "turnovers": 26,
            "assists_turnover_ratio": 3.42,
            "steals": 27,
            "blocks": 1,
            "personal_fouls": 30,
            "tech_fouls": 0,
            "points": 116,
            "flagrant_fouls": 0,
            "ejections": 0,
            "foulouts": 0,
            "true_shooting_att": 125.68,
            "true_shooting_pct": 0.461,
            "efficiency": 147,
            "field_goals_at_rim_made": 5,
            "field_goals_at_rim_att": 9,
            "field_goals_at_rim_pct": 0.556,
            "field_goals_at_midrange_made": 6,
            "field_goals_at_midrange_att": 27,
            "field_goals_at_midrange_pct": 0.222,
            "usage_pct": 20.23
          },
          "average": {
            "minutes": 10.8,
            "points": 3.4,
            "off_rebounds": 0.03,
            "def_rebounds": 0.53,
            "rebounds": 0.56,
            "assists": 2.6,
            "steals": 0.79,
            "blocks": 0.03,
            "turnovers": 0.76,
            "personal_fouls": 0.88,
            "flagrant_fouls": 0,
            "blocked_att": 0.15,
            "field_goals_made": 1.24,
            "field_goals_att": 3.41,
            "three_points_made": 0.44,
            "three_points_att": 1.18,
            "free_throws_made": 0.5,
            "free_throws_att": 0.65,
            "two_points_made": 0.79,
            "two_points_att": 2.24,
            "efficiency": 4.32,
            "true_shooting_att": 3.7
          }
        }
      ]
    },
    {
      "id": "3dcf4c11-e7f8-4996-a34d-49069d14d465",
      "year": 2023,
      "type": "PST",
      "teams": [
        {
          "id": "c10544de-e3bd-4776-ba2e-83df8c017fd1",
          "name": "Hawkeyes",
          "market": "Iowa",
          "alias": "IOWA",
          "total": {
            "games_played": 2,
            "games_started": 0,
            "minutes": 21,
            "field_goals_made": 5,
            "field_goals_att": 5,
            "field_goals_pct": 1,
            "two_points_made": 3,
            "two_points_att": 3,
            "two_points_pct": 1,
            "three_points_made": 2,
            "three_points_att": 2,
            "three_points_pct": 1,
            "blocked_att": 0,
            "free_throws_made": 0,
            "free_throws_att": 0,
            "free_throws_pct": 0,
            "offensive_rebounds": 0,
            "defensive_rebounds": 0,
            "rebounds": 0,
            "assists": 6,
            "turnovers": 2,
            "assists_turnover_ratio": 3,
            "steals": 0,
            "blocks": 0,
            "personal_fouls": 2,
            "tech_fouls": 0,
            "points": 12,
            "flagrant_fouls": 0,
            "ejections": 0,
            "foulouts": 0,
            "true_shooting_att": 5,
            "true_shooting_pct": 1.2,
            "efficiency": 16,
            "field_goals_at_rim_made": 2,
            "field_goals_at_rim_att": 2,
            "field_goals_at_rim_pct": 1,
            "field_goals_at_midrange_made": 1,
            "field_goals_at_midrange_att": 1,
            "field_goals_at_midrange_pct": 1,
            "usage_pct": 15.84
          },
          "average": {
            "minutes": 10.5,
            "points": 6,
            "off_rebounds": 0,
            "def_rebounds": 0,
            "rebounds": 0,
            "assists": 3,
            "steals": 0,
            "blocks": 0,
            "turnovers": 1,
            "personal_fouls": 1,
            "flagrant_fouls": 0,
            "blocked_att": 0,
            "field_goals_made": 2.5,
            "field_goals_att": 2.5,
            "three_points_made": 1,
            "three_points_att": 1,
            "free_throws_made": 0,
            "free_throws_att": 0,
            "two_points_made": 1.5,
            "two_points_att": 1.5,
            "efficiency": 8,
            "true_shooting_att": 2.5
          }
        }
      ]
    },
    {
      "id": "7aa53f56-bde6-441f-966b-161ecd993de5",
      "year": 2023,
      "type": "CT",
      "teams": [
        {
          "id": "c10544de-e3bd-4776-ba2e-83df8c017fd1",
          "name": "Hawkeyes",
          "market": "Iowa",
          "alias": "IOWA",
          "total": {
            "games_played": 1,
            "games_started": 0,
            "minutes": 17,
            "field_goals_made": 1,
            "field_goals_att": 3,
            "field_goals_pct": 0.333,
            "two_points_made": 0,
            "two_points_att": 2,
            "two_points_pct": 0,
            "three_points_made": 1,
            "three_points_att": 1,
            "three_points_pct": 1,
            "blocked_att": 1,
            "free_throws_made": 2,
            "free_throws_att": 2,
            "free_throws_pct": 1,
            "offensive_rebounds": 0,
            "defensive_rebounds": 1,
            "rebounds": 1,
            "assists": 5,
            "turnovers": 1,
            "assists_turnover_ratio": 5,
            "steals": 1,
            "blocks": 0,
            "personal_fouls": 2,
            "tech_fouls": 0,
            "points": 5,
            "flagrant_fouls": 0,
            "ejections": 0,
            "foulouts": 0,
            "true_shooting_att": 3.88,
            "true_shooting_pct": 0.644,
            "efficiency": 9,
            "field_goals_at_rim_made": 0,
            "field_goals_at_rim_att": 1,
            "field_goals_at_rim_pct": 0,
            "field_goals_at_midrange_made": 0,
            "field_goals_at_midrange_att": 0,
            "field_goals_at_midrange_pct": 0,
            "usage_pct": 14.02
          },
          "average": {
            "minutes": 17,
            "points": 5,
            "off_rebounds": 0,
            "def_rebounds": 1,
            "rebounds": 1,
            "assists": 5,
            "steals": 1,
            "blocks": 0,
            "turnovers": 1,
            "personal_fouls": 2,
            "flagrant_fouls": 0,
            "blocked_att": 1,
            "field_goals_made": 1,
            "field_goals_att": 3,
            "three_points_made": 1,
            "three_points_att": 1,
            "free_throws_made": 2,
            "free_throws_att": 2,
            "two_points_made": 0,
            "two_points_att": 2,
            "efficiency": 9,
            "true_shooting_att": 3.88
          }
        }
      ]
    }
  ]
}

Player IDs in other Products

Each NCAAMB player.id is specific to the NCAAMB API. IDs will not transfer to other basketball APIs. To learn more about linking IDs across API products visit this section.


Duplicate Player IDs

A duplicate player profile (and player.id) can be introduced by mistake. In these cases, we will mark the duplicate player with a status of DUP. All profiles marked as duplicates can be ignored, but they will remain in our database to limit confusion.

<player id="1b2259c6-01d3-4fe8-8b7c-359a222b6d4c" status="DUP" full_name="Brock Harding" first_name="Brock" last_name="Harding" abbr_name="B.Harding" height="72" weight="162" position="G" primary_position="NA" jersey_number="2" experience="SO" birth_place="Moline, IL, USA" updated="2024-07-15T15:02:44Z"></player>
{
  "id": "1b2259c6-01d3-4fe8-8b7c-359a222b6d4c",
  "status": "DUP",
  "full_name": "Brock Harding",
  "first_name": "Brock",
  "last_name": "Harding",
  "abbr_name": "B.Harding",
  "height": 72,
  "weight": 162,
  "position": "G",
  "primary_position": "NA",
  "jersey_number": "2",
  "experience": "SO",
  "birth_place": "Moline, IL, USA",
  "updated": "2024-07-15T15:02:44Z"
}

Access all Player IDs

Iterate through the past Seasonal Statistics feeds for each season and team to obtain all player IDs in the NCAAMB API.



Season IDs

Each NCAAMB season will have its own unique identifier under season.id. Season types can be CT (Conference Tournament), REG (Regular season), Postseason (PST) in the Seasons feed.

Season IDs will not change once created.

<league xmlns="http://feed.elasticstats.com/schema/basketball/seasons-v6.0.xsd" id="cd4268ee-07aa-4c4d-a435-ec44ad2c76cb" name="NCAA MEN" alias="NCAAM">
  <season id="3dcf4c11-e7f8-4996-a34d-49069d14d465" year="2023" start_date="2024-03-19" end_date="2024-04-08" status="closed">
    <type code="PST" name="Post-season Tournaments"/>
  </season>
  <season id="05b9e2ec-8916-432f-8a56-6579eb825dd0" year="2023" start_date="2023-11-06" end_date="2024-03-10" status="closed">
    <type code="REG" name="Regular Season"/>
  </season>
  <season id="7aa53f56-bde6-441f-966b-161ecd993de5" year="2023" start_date="2024-03-04" end_date="2024-03-17" status="closed">
    <type code="CT" name="Conference Tournaments"/>
  </season>
  <season id="b2e4c0e0-5571-47c3-ab8b-1db65d74234e" year="2024" start_date="2025-03-18" end_date="2025-04-07" status="scheduled">
    <type code="PST" name="Post-season Tournaments"/>
  </season>
  <season id="76df4cc8-67c8-4179-9387-e1dd5e884014" year="2024" start_date="2024-11-04" end_date="2025-03-09" status="scheduled">
    <type code="REG" name="Regular Season"/>
  </season>
  <season id="294a6ebb-7597-4e3b-890a-eef64eb661f9" year="2024" start_date="2025-03-03" end_date="2025-03-16" status="scheduled">
    <type code="CT" name="Conference Tournaments"/>
  </season>
</league>
{
  "league": {
    "id": "cd4268ee-07aa-4c4d-a435-ec44ad2c76cb",
    "name": "NCAA MEN",
    "alias": "NCAAM"
  },
  "seasons": [
    {
      "id": "3dcf4c11-e7f8-4996-a34d-49069d14d465",
      "year": 2023,
      "start_date": "2024-03-19",
      "end_date": "2024-04-08",
      "status": "closed",
      "type": {
        "code": "PST",
        "name": "Post-season Tournaments"
      }
    },
    {
      "id": "05b9e2ec-8916-432f-8a56-6579eb825dd0",
      "year": 2023,
      "start_date": "2023-11-06",
      "end_date": "2024-03-10",
      "status": "closed",
      "type": {
        "code": "REG",
        "name": "Regular Season"
      }
    },
    {
      "id": "7aa53f56-bde6-441f-966b-161ecd993de5",
      "year": 2023,
      "start_date": "2024-03-04",
      "end_date": "2024-03-17",
      "status": "closed",
      "type": {
        "code": "CT",
        "name": "Conference Tournaments"
      }
    },
    {
      "id": "b2e4c0e0-5571-47c3-ab8b-1db65d74234e",
      "year": 2024,
      "start_date": "2025-03-18",
      "end_date": "2025-04-07",
      "status": "scheduled",
      "type": {
        "code": "PST",
        "name": "Post-season Tournaments"
      }
    },
    {
      "id": "76df4cc8-67c8-4179-9387-e1dd5e884014",
      "year": 2024,
      "start_date": "2024-11-04",
      "end_date": "2025-03-09",
      "status": "scheduled",
      "type": {
        "code": "REG",
        "name": "Regular Season"
      }
    },
    {
      "id": "294a6ebb-7597-4e3b-890a-eef64eb661f9",
      "year": 2024,
      "start_date": "2025-03-03",
      "end_date": "2025-03-16",
      "status": "scheduled",
      "type": {
        "code": "CT",
        "name": "Conference Tournaments"
      }
    }
  ]
}


Venue IDs

Each NCAAMB venue will have its own unique identifier under venue.id. You can locate all active team venues in Team Profile, and each Game feed will include the venue ID for that matchup.

Venue IDs will not change once created.

<team xmlns="http://feed.elasticstats.com/schema/basketball/team-v8.0.xsd" id="efba5350-79bc-47aa-a189-db177b95b491" name="Huskies" market="UConn" alias="CONN" founded="1881" mascot="Jonathan the Husky" fight_song="UConn Husky" championships_won="6" conference_titles="9" playoff_appearances="36">
  <venue id="0d1fc5bc-9f37-4f19-af35-c081088ae93d" name="Harry A. Gampel Pavilion" capacity="10167" address="2095 Hillside Road" city="Storrs" state="CT" zip="06268" country="USA">
    <location lat="41.805292" lng="-72.254194"/>
  </venue>
  <hierarchy>
    <league id="cd4268ee-07aa-4c4d-a435-ec44ad2c76cb" name="NCAA MEN" alias="NCAAM"/>
    <division id="c5a8d640-5093-4044-851d-2c562e929994" name="NCAA Division I" alias="D1"/>
    <conference id="d07bc93e-c84c-44a9-a99d-c213bd0014d6" name="Big East" alias="BIGEAST"/>
  </hierarchy>
  <coaches>
    <coach id="1d0f4b4c-e651-43bd-abbf-24e13e762af8" full_name="Dan Hurley" first_name="Dan" last_name="Hurley" position="Head Coach"/>
  </coaches>
  <team_colors>
    <team_color type="primary" hex_color="#000e2f">
      <rgb_color red="0" green="14" blue="47"/>
    </team_color>
    <team_color type="secondary" hex_color="#ffffff">
      <rgb_color red="255" green="255" blue="255"/>
    </team_color>
  </team_colors>
</team>
{
  "id": "efba5350-79bc-47aa-a189-db177b95b491",
  "name": "Huskies",
  "market": "UConn",
  "alias": "CONN",
  "founded": 1881,
  "mascot": "Jonathan the Husky",
  "fight_song": "UConn Husky",
  "championships_won": 6,
  "conference_titles": 9,
  "playoff_appearances": 36,
  "venue": {
    "id": "0d1fc5bc-9f37-4f19-af35-c081088ae93d",
    "name": "Harry A. Gampel Pavilion",
    "capacity": 10167,
    "address": "2095 Hillside Road",
    "city": "Storrs",
    "state": "CT",
    "zip": "06268",
    "country": "USA",
    "location": {
      "lat": "41.805292",
      "lng": "-72.254194"
    }
  }
}

The Sportradar IDs will be consistent across sports and leagues, where available. Meaning those venue IDs would be consistent across APIs.