GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

Basketball APIs - Player Id Linking

You can now reference a player’s NCAA or G League profile within the NBA API and WNBA API!

When available, each player’s profile includes the corresponding ID from the NCAA Basketball API and NBA G League API under player.reference(s), making it easier to connect college and pro profiles for analysis, draft prep, and career stats.


☑️ Sample Requests

Player Profile (NBA) - https://api.sportradar.com/nba/trial/v8/en/players/ab532a66-9314-4d57-ade7-bb54a70c65ad/profile.json

Team Profile (WNBA) - https://api.sportradar.com/wnba/trial/v8/en/teams/f073a15f-0486-4179-b0a3-dfd0294eb595/profile.xml


🔢 Versions


🔁 Endpoints Affected

  • Player Profile, Team Profile

⚙️ Return Samples

{
    "id": "ab532a66-9314-4d57-ade7-bb54a70c65ad",
    "status": "ACT",
    "full_name": "Karl-Anthony Towns",
    "first_name": "Karl-Anthony",
    "last_name": "Towns",
    "abbr_name": "K.Towns",
    "height": 84,
    "weight": 248,
    "position": "C-F",
    "primary_position": "C",
    "jersey_number": "32",
    "experience": "10",
    "college": "Kentucky",
    "high_school": "St. Joseph (NJ)",
    "birth_place": "Edison, NJ, USA",
    "birthdate": "1995-11-15",
    "updated": "2025-07-16T19:57:53Z",
    "sr_id": "sr:player:852120",
    "rookie_year": 2015,
    "salary": 55110496,
    "reference": "1626157",
    "league": {
        "id": "4353138d-4c22-4396-95d8-5f587d2df25c",
        "name": "NBA",
        "alias": "NBA"
    },
    "team": {
        "id": "583ec70e-fb46-11e1-82cb-f4ce4684ea4c",
        "name": "Knicks",
        "market": "New York",
        "alias": "NYK",
        "sr_id": "sr:team:3421",
        "reference": "1610612752"
    },
    "draft": {
        "team_id": "583eca2f-fb46-11e1-82cb-f4ce4684ea4c",
        "year": 2015,
        "round": "1",
        "pick": "1"
    },
    "references": [
        {
            "source_id": "1626157",
            "scope": "NBA",
            "id_type": "external"
        },
        {
            "source_id": "538c349d-add1-4913-802c-6d2ed4136394",
            "scope": "basketball",
            "id_type": "sport_profile"
        },
        {
            "source_id": "396e91cc-0f15-4f2c-b79a-15c69b6e0416",
            "scope": "NCAAM",
            "id_type": "league_profile"
        }
    ],
<player id="2b95727a-4273-4f8f-a45b-3d9ac9969dba" status="ACT" full_name="Terrence Shannon Jr." first_name="Terrence" last_name="Shannon" abbr_name="T.Shannon" height="78" weight="215" position="G-F" primary_position="SG" jersey_number="1" experience="1" college="Illinois" high_school="IMG Academy (FL)" birth_place="Chicago, IL, USA" birthdate="2000-07-30" updated="2025-07-16T22:54:47Z" name_suffix="Jr." sr_id="sr:player:1875284" rookie_year="2024" salary="3269130" reference="1630545">
          <draft team_id="583eca2f-fb46-11e1-82cb-f4ce4684ea4c" year="2024" round="1" pick="27"/>
          <references>
              <reference source_id="1630545" scope="NBA" id_type="external"/>
              <reference source_id="338f7499-0163-43b3-9d66-a172b5f49ef8" scope="basketball" id_type="sport_profile"/>
              <reference source_id="ba068aa2-e09e-4439-b137-f93f4c77aeb4" scope="NCAAM" id_type="league_profile"/>
              <reference source_id="8ca1b30d-b62e-4273-8642-02b4e936ebcc" scope="NBDL" id_type="league_profile"/>
          </references>
</player>