Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs
Coverage MatrixDocumentationChange LogLog InContact Us

NCAAMB Change Log

Find all updates to the NCAA Men's Basketball v8 API and its documentation

Game-Level Tournament Seed

🗓️ Release Date 08/25/2026

We've added tournament seed information at the game level for our NCAA Men's and Women's Basketball APIs.

Going forward, locate each team's tournament seed in the relevant Game endpoint (Boxscore, Play-by-Play, Summary).

Return Samples
<team name="Hawkeyes" alias="IOWA" market="Iowa" id="c10544de-e3bd-4776-ba2e-83df8c017fd1" points="59" rank="0" seed="9" remaining_timeouts="1">

⭐ Benefit

For NCAA Tournament games, easily capture and display each team's tournament seed from the game feed — without the need to sync to the Schedule feed(s).

📋 Recommended Actions

  • Read each team's seed from the Game feeds (Boxscore, Play-by-Play, Summary) to display tournament seeding directly, without cross-referencing the Series or Schedule feeds.
  • Note the location differs by feed and format: in some feeds seed sits on the team nodes (e.g. Men's Game Summary), in others on the home/away objects (e.g. Women's Play-by-Play). Map per feed rather than assuming one path.
  • Handle non-tournament cases: confirm what seed returns for teams or games outside the tournament (e.g. 0 or absent) and guard your display so unseeded teams don't render as "seed 0."

☑️ Sample Requests:

curl --request GET \
     --url https://api.sportradar.com/ncaamb/trial/v8/en/games/af161a87-bd65-4bb8-94ae-29e20077d352/summary.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'
curl --request GET \
     --url https://api.sportradar.com/ncaawb/trial/v8/en/games/b9894f05-94ad-4357-ab02-901d4360804d/pbp.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

SportProductVersion(s)
BasketballNCAA Men's Basketballv8, v7, v4
BasketballNCAA Women's Basketball APIv8, v7, v3

🔁 Endpoints Affected

  • Game Boxscore
  • Game Play-by-Play
  • Game Summary

⚙️ Return Samples

Return Samples
<game xmlns="http://feed.elasticstats.com/schema/basketball/game-v8.0.xsd" id="af161a87-bd65-4bb8-94ae-29e20077d352" title="South Regional - Elite Eight - Game 1" status="closed" coverage="full" neutral_site="true" scheduled="2026-03-28T22:09:00+00:00" conference_game="false" attendance="17010" lead_changes="13" times_tied="7" clock="00:00" half="2" track_on_court="true" entry_mode="LDE" clock_decimal="00:00" home_team="150148c2-ca8f-414f-8f41-d94a55d4a122" away_team="c10544de-e3bd-4776-ba2e-83df8c017fd1">
    <broadcasts>
        <broadcast type="TV" locale="National" network="TBS" channel="247"/>
        <broadcast type="TV" locale="National" network="truTV" channel="246"/>
        <broadcast type="Internet" locale="National" network="HBO Max"/>
    </broadcasts>
    <season id="fd1c5f6a-54fc-400a-a7f6-c7b38a6091fe" year="2025" type="PST" name="Post-season Tournaments"/>
    <time_zones venue="US/Central" home="US/Central" away="US/Central"/>
    <venue id="5b239206-57ce-50aa-baaa-627f3349dfdc" name="Toyota Center" capacity="18500" address="1510 Polk Street" city="Houston" state="TX" zip="77002" country="USA">
        <location lat="29.750751" lng="-95.362049"/>
    </venue>
    <team name="Fighting Illini" alias="ILL" market="Illinois" id="150148c2-ca8f-414f-8f41-d94a55d4a122" points="71" rank="13" seed="3" remaining_timeouts="2" home="true">
    <!-- ...additional game data omitted... -->
    </team>
</game>
{
    "id": "b9894f05-94ad-4357-ab02-901d4360804d",
    "title": "Fort Worth 1 - Sweet 16 - Game 1",
    "status": "closed",
    "coverage": "full",
    "neutral_site": true,
    "scheduled": "2026-03-27T21:15:00+00:00",
    "conference_game": false,
    "attendance": 9375,
    "lead_changes": 6,
    "times_tied": 0,
    "clock": "00:00",
    "quarter": 4,
    "track_on_court": false,
    "entry_mode": "LDE",
    "clock_decimal": "00:00",
    "possession_arrow": "6e196896-2649-411e-98fa-4f34a01b3ba9",
    "broadcasts": [
        {
            "type": "TV",
            "locale": "National",
            "network": "ESPN",
            "channel": "206"
        }
    ],
    "time_zones": {
        "venue": "US/Central",
        "home": "US/Eastern",
        "away": "US/Eastern"
    },
    "season": {
        "id": "6d9ae91c-9cdd-44c6-b2b9-ff2a005678df",
        "year": 2025,
        "type": "PST",
        "name": "Post-season Tournaments"
    },
    "home": {
        "name": "Huskies",
        "alias": "CONN",
        "market": "UConn",
        "id": "6e0c5edc-4a6d-416b-9e10-7cccf13e971f",
        "points": 63,
        "rank": 1,
        "seed": 1,
        "remaining_timeouts": 2
    },
    "away": {
        "name": "Tar Heels",
        "alias": "UNC",
        "market": "North Carolina",
        "id": "6e196896-2649-411e-98fa-4f34a01b3ba9",
        "points": 42,
        "rank": 15,
        "seed": 4,
        "remaining_timeouts": 1
    }
    // ...additional game data omitted...
}

Awards Endpoints

🗓️ Release Date 08/25/2026

We've added two new awards-based endpoints to the following APIs: NCAA Football, NCAA Men's Basketball, NCAA Women's Basketball, and WNBA. Use these feeds to access award definitions and seasonal award recipients.

  • Awards List: Provides a list of all awards available in the API.
  • Seasonal Awards: Provides all award recipients for a given season and season type.

⭐ Benefit

With these endpoints, access award data for honors such as Most Valuable Player, National Champions, Heisman Trophy winners, Rookies of the Year, and more. Track annual recipients going forward to enrich your player and team profiles.

📋 Recommended Actions

  • Call the Awards List endpoint to retrieve all award definitions for a league (league-wide, no season parameter), and Seasonal Awards to retrieve recipients for a given season year and season type.
  • Note the two endpoints have different request shapes: Awards List is /league/awards/list, while Seasonal Awards takes a season year and type (e.g. /seasons/2025/REG/awards). Map each per endpoint rather than assuming one path.
  • Use the type field (e.g. player, team, coach) to route each award to the right entity, and handle awards with multiple recipients (e.g. All-America teams return several winners under one award).
  • Join recipients to your existing player and team records via the returned id values to enrich profiles with honors.

☑️ Sample Requests:

curl --request GET \
     --url https://api.sportradar.com/ncaafb/trial/v7/en/seasons/2025/REG/awards.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'
curl --request GET \
     --url https://api.sportradar.com/ncaamb/trial/v8/en/league/awards/list.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'
curl --request GET \
     --url https://api.sportradar.com/wnba/trial/v8/en/seasons/2025/REG/awards.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'
curl --request GET \
     --url https://api.sportradar.com/ncaawb/trial/v8/en/league/awards/list.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

SportProductVersion(s)
FootballNCAA Football APIv7
BasketballNCAA Men's Basketballv8
BasketballNCAA Women's Basketball APIv8
BasketballWNBA APIv8

🔁 Endpoints Affected

  • Awards List
  • Seasonal Awards

⚙️ Return Samples

Return Samples
<league xmlns="http://feed.elasticstats.com/schema/football/awards-v7.0.xsd" id="26c1246a-2fc3-4b7e-8999-1685d3ab4676" name="NCAA Football" alias="NCAAFB">
    <award id="d95a2799-398e-4427-96aa-a715071139d7" name="AP All-America 1st Team" description="Awarded to the top players that season at each position. Typically consists of 3 teams of offensive and defensive players." type="player"/>
    <award id="c6f6c0ab-425d-4ed9-bd8d-009ac34c446a" name="AP All-America 2nd Team" description="Awarded to the top players that season at each position. Typically consists of 3 teams of offensive and defensive players." type="player"/>
    <!-- ...additional awards omitted... -->
</league>
{
    "name": "Rookie of the Year",
    "description": "Awarded to the top rookie of the regular season.",
    "type": "player",
    "effective_date": "2025-09-16",
    "awarded_time_frequency": "annual",
    "awarded_time_period": "2025",
    "id": "18634438-55a4-46d5-b076-647479b23bfd",
    "recipients": [
        {
            "level": "winner",
            "name": "Paige Bueckers",
            "position": "G",
            "id": "80c92207-2597-4132-a34c-3b467a1a81e1",
            "alias": "DAL",
            "market": "Dallas",
            "team": {
                "id": "5f0b5caf-708b-4300-92f2-53b51d83ec06",
                "name": "Wings",
                "alias": "DAL",
                "market": "Dallas"
            }
        }
    ]
},
{
    "name": "Coach of the Year",
    "description": "Awarded to the coach deemed most integral to their team's success.",
    "type": "coach",
    "effective_date": "2025-09-17",
    "awarded_time_frequency": "annual",
    "awarded_time_period": "2025",
    "id": "de6b99ac-a791-4ab8-bc31-b34a6883003b",
    "recipients": [
        {
            "level": "winner",
            "name": "Natalie Nakase",
            "position": "Head Coach",
            "id": "850fba08-59de-48c9-9afe-2cd369e90f2e",
            "alias": "GSV",
            "market": "Golden State",
            "team": {
                "id": "4f57ec40-0d35-4b59-bea0-9d040f0d2292",
                "name": "Valkyries",
                "alias": "GSV",
                "market": "Golden State"
            }
        }
    ]
}
// ...additional awards omitted...
{
    "id": "43241810-acf4-4701-b67a-d7c74b583fde",
    "name": "National Champion",
    "description": "Winner of the NCAA Tournament",
    "type": "team"
},
{
    "id": "5a2bb94e-12ff-4deb-b255-1c0ed3cea413",
    "name": "NCAA Tournament Most Outstanding Player",
    "description": "Awarded to the most outstanding player in that year's Final Four.",
    "type": "player"
},
{
    "id": "49b233ff-d668-4133-ab9e-5371e6bdae7d",
    "name": "NIT Champion",
    "description": "Winner of the National Invitational Tournament (NIT)",
    "type": "team"
}
// ...additional awards omitted...
<award name="AP All-America 2nd Team" description="Awarded to the best college basketball players in a season. Typically consists of 3 5-player lineups." type="player" effective_date="2026-03-18" awarded_time_frequency="annual" awarded_time_period="2025-26" id="0d779e0b-abea-4378-a313-831b34bfbb43">
<recipient level="winner" name="Olivia Miles" position="G" id="c1b1b9e6-cba5-420c-82cc-ef3de3c09fbc">
</recipient>
</award>
<award name="AP All-America 2nd Team" description="Awarded to the best college basketball players in a season. Typically consists of 3 5-player lineups." type="player" effective_date="2026-03-18" awarded_time_frequency="annual" awarded_time_period="2025-26" id="0d779e0b-abea-4378-a313-831b34bfbb43">
<recipient level="winner" name="Joyce Edwards" position="F" id="d8c36619-a8ef-43a7-ac8a-2154dc13b5fa" alias="SCAR" market="South Carolina">
    <team id="7f4f0451-6b78-4082-9503-ce851e549b0c" name="Gamecocks" alias="SCAR" market="South Carolina"/>
</recipient>
</award>
<!-- ...additional awards omitted... -->

Fifth-Year Eligibility Status

🗓️ Release Date 07/29/2026

We've added support for fifth-year student athletes in each of our NCAA APIs (NCAA Football, NCAA Men's Basketball, NCAA Women's Basketball, NCAA Men's Hockey).

Beginning this season, the experience or eligibility field may return a value of 5th.

📋

Field name varies by API: NCAA Football uses the eligibility field, while NCAA Men's Basketball, NCAA Women's Basketball, and NCAA Men's Hockey use experience.

Fifth-year players will be added to these APIs over the coming weeks, as teams update their rosters. You may not see 5th values immediately.

Here are the valid player experience and eligibility values:

  • FR - Freshman
  • SO - Sophomore
  • JR - Junior
  • SR - Senior
  • 5th - Fifth-year student-athlete
  • GR - Graduate student

⭐ Benefit

Use this new player status to build more accurate and complete rosters and player profiles.

📋 Recommended Actions

  • Update your roster and profile parsing to accept 5th as a valid value in the experience field (or eligibility for NCAA Football).
  • Confirm you read the correct field per API: eligibility for NCAA Football, experience for NCAA Men's/Women's Basketball and NCAA Men's Hockey.
  • Add display handling for fifth-year student-athletes wherever you show player class or eligibility.
  • Expect 5th values to populate over the coming weeks as teams update their rosters.

☑️ Sample Requests:

curl --request GET \
     --url https://api.sportradar.com/ncaafb/trial/v7/en/teams/{team_id}/full_roster.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

SportProductVersion(s)
FootballNCAA Football APIv7
BasketballNCAA Men's Basketballv8, v7, v4
BasketballNCAA Women's Basketball APIv8, v7, v3
HockeyNCAA Men's Hockey APIv3

🔁 Endpoints Affected

NCAA Football API

  • Game Roster
  • Player Profile
  • Team Roster

NCAA Men's Basketball API

  • Player Profile
  • Team Profile

NCAA Women's Basketball API

  • Player Profile
  • Team Profile

NCAA Men's Hockey

  • Team Profile

⚙️ Return Samples

Return Samples
<player id="948dbd20-3fa7-11ef-83b9-f50a2c2b262b" name="DayDay Nelson" jersey="13" last_name="Nelson" first_name="DayDay" abbr_name="D.Nelson" weight="203.0" height="75" position="LB" birth_place="South Phoenix, AZ, USA" status="ACT" eligibility="5TH">
<player id="178468d8-54ad-45ca-9b2d-dfadfd819345" status="ACT" full_name="Jane Basketball" first_name="Jane" last_name="Basketball" abbr_name="J.Basketball" height="73" position="F" primary_position="NA" jersey_number="23" experience="5th" birth_place="Johnston, IA, USA" updated="2025-07-16T16:50:36+00:00">
</player>

Daily Transfers Endpoint

🗓️ Release Date 07/27/2026

We’ve added a Daily Transfers endpoint to our NCAA Men's Basketball API to assist in tracking players' transfers to new schools.

This new endpoint provides all transactions recorded by the league on a given day, regardless of each transaction's effective date.

⭐ Benefit

You can now track when a player has officially transferred to a new school by requesting this endpoint each day during the offseason. While transfer portal moves make up the majority of activity, the feed also reports other roster transactions such as commitments, releases, and suspensions.

Visit our FAQ for a complete list of transaction codes and types.

📋 Recommended Actions

  • Request the Daily Transfers endpoint each day (using the year/month/day path) to capture new transactions as the league records them.
  • Use the transaction_code / transaction_type fields to filter for the transaction categories relevant to your application, such as transfers, commitments, or releases.
  • Reference the effective_date separately from the record date, since transactions appear on the day they are recorded regardless of when they take effect.
  • See the full list of transaction codes and types in our NCAA Men's Basketball FAQ (link above).

☑️ Sample Request:

Daily Transfers

curl --request GET \
     --url https://api.sportradar.com/ncaamb/trial/v8/en/league/2026/07/22/transfers.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

SportProductVersion(s)
BasketballNCAA Men's Basketball APIv8

🔁 Endpoints Affected

⚙️ Return Samples

Return Samples
<transfers start_time="2026-07-21T04:00:00Z" end_time="2026-07-22T03:59:59Z">
    <player id="779289d0-9c1e-4d45-80b5-2b04cc7dfaae" full_name="Filip Brankovic" first_name="Filip" last_name="Brankovic" position="F" primary_position="NA">
        <transfer 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"/>
        </transfer>
    </player>
    <player id="ac828779-19b3-42f9-b246-9241906d1e04" full_name="L.J. Cason" first_name="L.J." last_name="Cason" position="G" primary_position="NA">
        <transfer 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)"/>
        </transfer>
    </player>
</transfers>
{
    "league": {
        "id": "cd4268ee-07aa-4c4d-a435-ec44ad2c76cb",
        "name": "NCAA MEN",
        "alias": "NCAAM"
    },
    "start_time": "2026-07-22T04:00:00Z",
    "end_time": "2026-07-23T03:59:59Z",
    "players": [
        {
            "id": "51ccd285-2442-4099-9f59-b312d8088972",
            "full_name": "Harun Zrno",
            "first_name": "Harun",
            "last_name": "Zrno",
            "position": "G",
            "primary_position": "NA",
            "transfers": [
                {
                    "id": "6d4e1c82-8501-40ed-bff3-b0003eb786ba",
                    "desc": "G Harun Zrno committed to the Washington Huskies.",
                    "effective_date": "2026-07-22",
                    "last_modified": "2026-07-22T19:46:44+00:00",
                    "transaction_type": "Activated",
                    "transaction_code": "ACT",
                    "to_team": {
                        "id": "e52c9644-717a-46f4-bf16-aeca000b3b44",
                        "name": "Huskies",
                        "market": "Washington"
                    }
                }
            ]
        }
    ]
}

Updated Action Area Coordinates

Release DateFeeds AffectedBenefit
12/1/2025All endpoints supporting play-by-play data.We've updated action area coordinates to provide a more accurate representation of what happens on the court.
Return Samples
{
          "id": "3f089a45-2e89-4572-891b-d81b0009498c",
          "clock": "20:00",
          "updated": "2025-04-08T00:51:48+00:00",
          "description": "Rueben Chinyelu vs. Joseph Tugler (Cougars gains possession)",
          "sequence": 1744073508872,
          "home_points": 0,
          "away_points": 0,
          "clock_decimal": "20:00",
          "created": "2025-04-08T00:51:48+00:00",
          "event_type": "opentip",
          "attribution": {
            "name": "Cougars",
            "market": "Houston",
            "id": "1f99a164-d593-4d81-85d5-0d7889d6f486",
            "team_basket": "right"
          },
          "location": {
            "coord_x": 562,
            "coord_y": 296,
            "action_area": "backcourt"

Translation Deprecation

Release DataFeeds AffectedUpdate
11/18/2025All endpoints supporting translations (teams, players, and play-by-play descriptions)Translation for NCAA Men's and NCAA Women's Basketball APIs have been deprecated due to minimal usage.

Clients interested in adding or restoring language support should contact their Sportradar sales representative for available options.

Forfeit Status

Release DateFeeds AffectedBenefit
11/12/2025

Daily Schedule

Game Boxscore

Game Play-by-Play

Game Summary

Schedule

Tournament Schedule

Push Events

Push Statistics

We've updated the behavior of forfeited games in all versions of our NCAA Basketball APIs.

Forfeit games now feature a status of forfeited and the winning team indicated with forfeit_winner="true". See our Forfeit workflow for more info.

Return Samples
{
    "id": "2af28de9-6fdf-4d01-ba28-5fdeb2e1d2ae",
    "status": "forfeited",
    "coverage": "full",
    "scheduled": "2025-01-12T22:00:00+00:00",
    "conference_game": true,
    "track_on_court": false,
    "entry_mode": "LDE",
    "time_zones": {
        "venue": "US/Pacific",
        "home": "US/Pacific",
        "away": "US/Central"
    },
    "season": {
        "id": "a263b759-0702-45fb-803a-b1c0651da16f",
        "year": 2024,
        "type": "REG",
        "name": "Regular Season"
    },
    "home": {
        "name": "Bruins",
        "alias": "UCLA",
        "market": "UCLA",
        "id": "a983fe02-db1e-4137-9cfe-34d9eaca890c",
        "forfeit_winner": true,
        "points": 0,
        "rank": 1,
        "remaining_timeouts": 4,
        "scoring": []
    },
    "away": {
        "name": "Wildcats",
        "alias": "NW",
        "market": "Northwestern",
        "id": "fc923213-ae54-4bb9-8ef4-f16d7a16dfe0",
        "forfeit_winner": false,
        "points": 0,
        "rank": 0,
        "remaining_timeouts": 4,
        "scoring": []
    }
}
<game xmlns="http://feed.elasticstats.com/schema/basketball/game-v8.0.xsd" id="2af28de9-6fdf-4d01-ba28-5fdeb2e1d2ae" status="forfeited" coverage="full" scheduled="2025-01-12T22:00:00+00:00" conference_game="true" track_on_court="false" entry_mode="LDE" home_team="a983fe02-db1e-4137-9cfe-34d9eaca890c" away_team="fc923213-ae54-4bb9-8ef4-f16d7a16dfe0">
    <season id="a263b759-0702-45fb-803a-b1c0651da16f" year="2024" type="REG" name="Regular Season"/>
    <time_zones venue="US/Pacific" home="US/Pacific" away="US/Central"/>
    <team name="Bruins" alias="UCLA" market="UCLA" id="a983fe02-db1e-4137-9cfe-34d9eaca890c" forfeit_winner="true" points="0" rank="1" remaining_timeouts="4" home="true">
        <scoring>
    </scoring>
        <leaders>
    </leaders>
    </team>
    <team name="Wildcats" alias="NW" market="Northwestern" id="fc923213-ae54-4bb9-8ef4-f16d7a16dfe0" forfeit_winner="false" points="0" rank="0" remaining_timeouts="4">
        <scoring>
    </scoring>
        <leaders>
    </leaders>
    </team>
</game>

Timestamp Format Update

Release DateFeeds AffectedBenefit
11/12/2025

Daily Schedule

Schedule

Player Profile

Team Profile

Daily Change Log

We've updated the format of certain timestamp data points in our US Basketball APIs. Going forward, timestamps will use the 2025-10-28T22:56:48+00:00 format instead of 2025-10-28T22:56:48Z.

Both formats follow the ISO 8601 standard and represent the same UTC time. However, older games or data may still include the previous format.

This update applies to the following fields:
  • game.scheduled — in Daily Schedule and Schedule endpoints
  • player.updated — in Player Profile, Free Agents, and Team Profile endpoints
  • last_modified — in Daily Change Log and Daily Transfers endpoints
Return Samples
{
    "league": {
        "id": "4353138d-4c22-4396-95d8-5f587d2df25c",
        "name": "NBA",
        "alias": "NBA"
    },
    "start_time": "2025-11-10T05:00:00Z",
    "end_time": "2025-11-11T04:59:59Z",
    "players": [
        {
            "id": "3a3207cc-269f-47ef-9b77-f852f0bed4b0",
            "full_name": "Quinten Post",
            "last_modified": "2025-11-10T13:00:52+00:00",
            "sr_id": "sr:player:1889798",
            "reference": "1642366"
        },
        {
            "id": "48b05ddf-0a9f-4426-9394-231c54726eaa",
            "full_name": "Monté Morris",
            "last_modified": "2025-11-10T21:51:28+00:00",
            "sr_id": "sr:player:1142586",
            "reference": "1628420"
        },
        {
            "id": "b173be95-9411-4fa9-afa3-ff231db0ed4d",
            "full_name": "Colby Jones",
            "last_modified": "2025-11-10T18:47:33+00:00",
            "sr_id": "sr:player:2075233",
            "reference": "1641732"
        },
        {
            "id": "e23521cd-8e92-4701-b9e7-dc4acd21dfec",
            "full_name": "Wendell Moore Jr.",
            "last_modified": "2025-11-10T18:50:28+00:00",
            "sr_id": "sr:player:2826111",
            "reference": "1631111"
        }
    ],
            <game id="820c5325-360f-4b9e-a67c-77fe71338871" status="closed" coverage="full" scheduled="2025-10-21T23:30:00+00:00" home_points="125" away_points="124" track_on_court="true" sr_id="sr:match:62757053" reference="0022500001" home_team="583ecfff-fb46-11e1-82cb-f4ce4684ea4c" away_team="583ecb3a-fb46-11e1-82cb-f4ce4684ea4c">
                <time_zones venue="US/Central" home="US/Central" away="US/Central"/>
                <venue id="a13af216-4409-5021-8dd5-255cc71bffc3" name="Paycom Center" capacity="18203" address="100 W. Reno Avenue" city="Oklahoma City" state="OK" zip="73102" country="USA" sr_id="sr:venue:6934">
                    <location lat="35.463333" lng="-97.515"/>
                </venue>
                <home name="Oklahoma City Thunder" alias="OKC" id="583ecfff-fb46-11e1-82cb-f4ce4684ea4c" sr_id="sr:team:3418" reference="1610612760">
        </home>
                <away name="Houston Rockets" alias="HOU" id="583ecb3a-fb46-11e1-82cb-f4ce4684ea4c" sr_id="sr:team:3412" reference="1610612745">
        </away>
                <broadcasts>
                    <broadcast network="NBC/Peacock" type="TV" locale="National"/>
                </broadcasts>
            </game>
{
    "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:53+00:00",
    "sr_id": "sr:player:852120",
    "rookie_year": 2015,
    "salary": 55110496,
    "reference": "1626157",
    "league": {
        "id": "4353138d-4c22-4396-95d8-5f587d2df25c",
        "name": "NBA",
        "alias": "NBA"
    },

Transfer Portal Endpoint

Release DateFeeds AffectedBenefit
10/24/2025Transfer Portal

We've added a Transfer Portal endpoint to our NCAA Men's and Women's basketball APIs. The endpoint lists all players currently in the NCAA Transfer Portal for each league.

Use this endpoint to track player movement, scout talent, and stay informed on roster changes across college programs.

Return Samples
{
    "league": {
        "id": "affab7b6-647e-4304-bbe2-1f9d68cd0cea",
        "name": "NCAA WOMEN",
        "alias": "NCAAW",
        "transfer_portal_players": [
            {
                "id": "b3010c63-c53d-436b-b310-bebf50e4ad9a",
                "full_name": "Mallory Heyer",
                "first_name": "Mallory",
                "last_name": "Heyer",
                "abbr_name": "M.Heyer",
                "height": 73,
                "birth_place": "Chaska, MN, USA",
                "updated": "2025-10-23T14:44:47Z",
                "position": "F",
                "primary_position": "NA",
                "experience": "SR"
            }
        ]
    },
    "_comment": "Generation started @ 2025-10-24 14:46:52 +0000 ended @ 2025-10-24 14:46:52 +0000"
}
<league xmlns="http://feed.elasticstats.com/schema/basketball/ncaam/transfer-portal-v8.0.xsd" id="cd4268ee-07aa-4c4d-a435-ec44ad2c76cb" name="NCAA MEN" alias="NCAAM">
    <transfer_portal_players id="89577959-be23-430a-9b86-7b6e19b26929" full_name="Kristiyan Popov" first_name="Kristiyan" last_name="Popov" abbr_name="K.Popov" height="79" weight="215" birth_place="Varna,, BGR" updated="2025-10-06T14:47:25Z" position="G" primary_position="NA" experience="SO"/>
</league>

Transfer Portal Player Status

Release DateFeeds AffectedBenefit
09/16/2025Player ProfileWe've added a player status (TP) for players who have entered the transfer portal.
Return Samples
<player xmlns="http://feed.elasticstats.com/schema/basketball/profile-v8.0.xsd" id="56d20a4a-982b-4e0c-bc52-eca8e76c8e73" status="TP" full_name="Boogie Fland" first_name="Boogie" last_name="Fland" abbr_name="B.Fland" height="75" weight="180" position="G" primary_position="NA" jersey_number="0" experience="SO" birth_place="Bronx, NY, USA" updated="2025-07-17T15:42:38Z">
{
    "id": "56d20a4a-982b-4e0c-bc52-eca8e76c8e73",
    "status": "TP",
    "full_name": "Boogie Fland",
    "first_name": "Boogie",
    "last_name": "Fland",
    "abbr_name": "B.Fland",
    "height": 75,
    "weight": 180,
    "position": "G",
    "primary_position": "NA",
    "jersey_number": "0",
    "experience": "SO",
    "birth_place": "Bronx, NY, USA",
    "updated": "2025-07-17T15:42:38Z",
    "league": {
        "id": "cd4268ee-07aa-4c4d-a435-ec44ad2c76cb",
        "name": "NCAA MEN",
        "alias": "NCAAM"
    },
    "references": [
        {
            "source_id": "c73e2a89-5c71-40c0-a81c-b209f8ff2c89",
            "scope": "basketball",
            "id_type": "sport_profile"
        }
    ],

Player ID Linking

Release DateFeeds AffectedBenefit
08/28/2025

Player Profile

Team Profile

You can now reference a player’s NBA or G League profile within the NCAA Men's Basketball API!

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

Also included is a basketball "parent Id", which provides a consistent Id for a player across the NBA, NCAAMB, and G League APIs.

Return Samples
<player xmlns="http://feed.elasticstats.com/schema/basketball/profile-v8.0.xsd" id="9dd5bcf8-74b3-40d7-9173-bea73d0d8779" status="NWT" full_name="Cooper Flagg" first_name="Cooper" last_name="Flagg" abbr_name="C.Flagg" height="81" weight="205" position="G-F" primary_position="NA" experience="FR" birth_place="Newport, ME, USA" updated="2025-06-26T15:10:31Z">
    <league id="cd4268ee-07aa-4c4d-a435-ec44ad2c76cb" name="NCAA MEN" alias="NCAAM"/>
    <references>
        <reference source_id="1d323a11-1758-4975-ba6f-1a03b7a2157c" scope="NBA" id_type="league_profile"/>
        <reference source_id="ab563e54-1eba-44f0-a4a7-ee75b7383f0a" scope="basketball" id_type="sport_profile"/>
    </references>
{
    "id": "9dd5bcf8-74b3-40d7-9173-bea73d0d8779",
    "status": "NWT",
    "full_name": "Cooper Flagg",
    "first_name": "Cooper",
    "last_name": "Flagg",
    "abbr_name": "C.Flagg",
    "height": 81,
    "weight": 205,
    "position": "G-F",
    "primary_position": "NA",
    "experience": "FR",
    "birth_place": "Newport, ME, USA",
    "updated": "2025-06-26T15:10:31Z",
    "league": {
        "id": "cd4268ee-07aa-4c4d-a435-ec44ad2c76cb",
        "name": "NCAA MEN",
        "alias": "NCAAM"
    },
    "references": [
        {
            "source_id": "1d323a11-1758-4975-ba6f-1a03b7a2157c",
            "scope": "NBA",
            "id_type": "league_profile"
        },
        {
            "source_id": "ab563e54-1eba-44f0-a4a7-ee75b7383f0a",
            "scope": "basketball",
            "id_type": "sport_profile"
        }
    ],

Season Info in Daily Schedule

Release DateFeeds AffectedBenefit
07/25/2025Daily Schedule

We've added season information to the Daily Schedule endpoint in all US basketball APIs.

Leverage the new season node to easily identify which season a game belongs to.

Return Samples
{
    "date": "2025-07-25",
    "league": {
        "id": "59c24590-0adb-4b3d-80a8-10450f83f4a1",
        "name": "WNBA",
        "alias": "WNBA"
    },
    "games": [
        {
            "id": "0141c94b-0923-4c3f-8e2f-50513198e128",
            "status": "scheduled",
            "coverage": "full",
            "scheduled": "2025-07-25T23:30:00Z",
            "track_on_court": true,
            "sr_id": "sr:match:56328197",
            "reference": "1022500156",
            "cc_cup": false,
            "time_zones": {
                "venue": "US/Central",
                "home": "US/Central",
                "away": "US/Pacific"
            },
            "season": {
                "id": "896588ff-6de9-49a9-a799-bbd7d3922cdc",
                "year": 2025,
                "type": "REG"
            },
            "venue": {
                "id": "7aed802e-3562-5b73-af1b-3859529f9b95",
                "name": "Target Center",
                "capacity": 19356,
                "address": "600 First Avenue North",
                "city": "Minneapolis",
                "state": "MN",
                "zip": "55403",
                "country": "USA",
                "sr_id": "sr:venue:6930",
                "location": {
                    "lat": "44.979444",
                    "lng": "-93.276111"
                }
            },
            "broadcasts": [
                {
                    "network": "ION",
                    "type": "TV",
                    "locale": "National",
                    "channel": "305"
                }
            ],
            "home": {
                "name": "Minnesota Lynx",
                "alias": "MIN",
                "id": "6f017f37-be96-4bdc-b6d3-0a0429c72e89",
                "sr_id": "sr:team:3440"
            },
            "away": {
                "name": "Las Vegas Aces",
                "alias": "LVA",
                "id": "171b097d-01db-4ae8-9d56-035689402ec6",
                "sr_id": "sr:team:35550"
            }
        },
        {
            "id": "886f70ad-6601-4949-8361-19950f284336",
            "status": "scheduled",
            "coverage": "full",
            "scheduled": "2025-07-25T23:30:00Z",
            "track_on_court": true,
            "sr_id": "sr:match:56328195",
            "reference": "1022500155",
            "cc_cup": false,
            "time_zones": {
                "venue": "US/Eastern",
                "home": "US/Eastern",
                "away": "US/Arizona"
            },
            "season": {
                "id": "896588ff-6de9-49a9-a799-bbd7d3922cdc",
                "year": 2025,
                "type": "REG"
            },
            "venue": {
                "id": "7a330bcd-ac0f-50ca-bc29-2460e5c476b3",
                "name": "Barclays Center",
                "capacity": 17732,
                "address": "620 Atlantic Avenue",
                "city": "Brooklyn",
                "state": "NY",
                "zip": "11217",
                "country": "USA",
                "sr_id": "sr:venue:36132",
                "location": {
                    "lat": "40.682957",
                    "lng": "-73.975165"
                }
            },
            "broadcasts": [
                {
                    "network": "ION",
                    "type": "TV",
                    "locale": "National",
                    "channel": "305"
                }
            ],
            "home": {
                "name": "New York Liberty",
                "alias": "NYL",
                "id": "08ed8274-e29f-4248-bc2e-83cc8ed18d75",
                "sr_id": "sr:team:3446"
            },
            "away": {
                "name": "Phoenix Mercury",
                "alias": "PHX",
                "id": "0699edf3-5993-4182-b9b4-ec935cbd4fcc",
                "sr_id": "sr:team:3444"
            }
        },
        {
            "id": "d417a7b2-8eca-4edd-9e75-7875ed550fdd",
            "status": "scheduled",
            "coverage": "full",
            "scheduled": "2025-07-26T02:00:00Z",
            "track_on_court": true,
            "sr_id": "sr:match:56328199",
            "reference": "1022500157",
            "cc_cup": false,
            "time_zones": {
                "venue": "US/Pacific",
                "home": "US/Pacific",
                "away": "US/Central"
            },
            "season": {
                "id": "896588ff-6de9-49a9-a799-bbd7d3922cdc",
                "year": 2025,
                "type": "REG"
            },
            "venue": {
                "id": "938016dc-9e1d-4abc-88f5-3a7d772332e6",
                "name": "Chase Center",
                "capacity": 18064,
                "address": "1 Warriors Way",
                "city": "San Francisco",
                "state": "CA",
                "zip": "94158",
                "country": "USA",
                "sr_id": "sr:venue:44446",
                "location": {
                    "lat": "37.7679",
                    "lng": "-122.3873"
                }
            },
            "broadcasts": [
                {
                    "network": "ION",
                    "type": "TV",
                    "locale": "National",
                    "channel": "305"
                }
            ],
            "home": {
                "name": "Golden State Valkyries",
                "alias": "GSV",
                "id": "4f57ec40-0d35-4b59-bea0-9d040f0d2292",
                "sr_id": "sr:team:1200059"
            },
            "away": {
                "name": "Dallas Wings",
                "alias": "DAL",
                "id": "5f0b5caf-708b-4300-92f2-53b51d83ec06",
                "sr_id": "sr:team:3450"
            }
        }
    ]
}
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" charset="UTF-8" href="/xslt/basketball/schedule-v8.0.xsl"?>
<!-- Generation started @ 2025-07-25 14:04:25 UTC -->
<league xmlns="http://feed.elasticstats.com/schema/basketball/schedule-v8.0.xsd" id="cd4268ee-07aa-4c4d-a435-ec44ad2c76cb" name="NCAA MEN" alias="NCAAM">
    <daily-schedule date="2025-02-03">
        <games>
            <game id="9b28cfdb-759f-4cf4-b3c2-d0f83132615c" status="closed" coverage="full" scheduled="2025-02-03T23:00:00Z" home_points="94" away_points="68" conference_game="true" home_team="508f503f-dc57-4f4c-a01e-4f195e5c05c8" away_team="80a19b57-d6ab-4bee-934f-33a72c2e958a">
                <time_zones venue="US/Eastern" home="US/Eastern" away="US/Eastern"/>
                <season id="76df4cc8-67c8-4179-9387-e1dd5e884014" year="2024" type="REG"/>
                <venue id="7f83e6f9-fc09-437b-b4ec-a9b2121ac613" name="Stabler Arena" capacity="6000" address="124 Goodman Drive" city="Bethlehem" state="PA" zip="18015" country="USA">
                    <location lat="40.584444" lng="-75.356944"/>
                </venue>
                <home name="Lehigh Mountain Hawks" alias="LEH" id="508f503f-dc57-4f4c-a01e-4f195e5c05c8">
        </home>
                <away name="Colgate Raiders" alias="COLG" id="80a19b57-d6ab-4bee-934f-33a72c2e958a">
        </away>
                <broadcasts>
                    <broadcast network="CBS Sports Network" type="TV" locale="National" channel="221"/>
                </broadcasts>
            </game>
            <game id="1c5dc135-d1b2-4d63-aa5b-8334a6f44c16" status="closed" coverage="extended_boxscore" scheduled="2025-02-04T00:00:00Z" home_points="67" away_points="65" conference_game="true" home_team="d2ef641c-70e4-48bb-b40d-ac654d179205" away_team="912671c7-19fd-451b-813e-885485427820">
                <time_zones venue="US/Central" home="US/Central" away="US/Central"/>
                <season id="76df4cc8-67c8-4179-9387-e1dd5e884014" year="2024" type="REG"/>
                <venue id="9227adcc-38f3-4271-bd9a-c48b745be82e" name="The Legacy Center" capacity="4200" address="E McNeese Street" city="Lake Charles" state="LA" zip="70607" country="USA">
                    <location lat="30.1755" lng="-93.2095"/>
                </venue>
                <home name="McNeese Cowboys" alias="MCNS" id="d2ef641c-70e4-48bb-b40d-ac654d179205">
        </home>
                <away name="Incarnate Word Cardinals" alias="IW" id="912671c7-19fd-451b-813e-885485427820">
        </away>
                <broadcasts>
                    <broadcast network="ESPN+" type="Internet"/>
                </broadcasts>
            </game>

Parent Ids

Release DateFeeds AffectedBenefit
09/23/2024

Daily Schedule

Game Boxscore

Game Summary

Play-by-Play

Tournament List

Tournament Summary

Added a standard parent Id (parent_id) to games and tournaments.

Use this Id to group events (like March Madness) across seasons.

Return Samples
{
  "id": "54d776dc-0e88-4c77-8fe0-021d4ed7b250",
  "status": "closed",
  "title": "2024 NBA All-Star Game",
  "coverage": "full",
  "scheduled": "2024-02-19T01:00:00Z",
  "home_points": 211,
  "away_points": 186,
  "neutral_site": true,
  "parent_id": "e4986bda-2f75-4228-8295-44b2449088b1",
  "track_on_court": true,
  "reference": "0032300001",
  "time_zones": {
    "venue": "US/Eastern"
  },
  "venue": {
    "id": "24bb478e-eb31-5f8a-8c8d-07f513169ec1",
    "name": "Gainbridge Fieldhouse",
    "capacity": 20000,
    "address": "125 S. Pennsylvania Street",
    "city": "Indianapolis",
    "state": "IN",
    "zip": "46204",
    "country": "USA",
    "sr_id": "sr:venue:6924",
    "location": {
      "lat": "39.763975",
      "lng": "-86.15542"
    }
  },
  "broadcasts": [
    {
      "network": "TNT",
      "type": "TV",
      "locale": "National",
      "channel": "245"
    },
    {
      "network": "TBS",
      "type": "TV",
      "locale": "National",
      "channel": "247"
    }
  ],
  "home": {
    "name": "East NBA All Stars",
    "alias": "EST",
    "id": "592d3144-895b-43e9-ab15-e84666a845d5",
    "reference": "1610616833"
  },
  "away": {
    "name": "West NBA All Stars",
    "alias": "WST",
    "id": "787ff06f-f0cc-484e-8114-04e0cdc444fa",
    "reference": "1610616834"
  }
},
<series id="a6c5f648-2028-457f-84cd-bf301886648c" parent_id="a8187e6d-8b68-40bc-9767-fe78cbda3311" title="NBA Finals - MIA vs DEN" round="4" start_date="2023-06-01" status="closed">
  <participant name="Heat" seed="8" record="1">
    <team id="583ecea6-fb46-11e1-82cb-f4ce4684ea4c" name="Heat" alias="MIA" market="Miami" reference="1610612748"/>
    <source id="e75bdf18-b87a-4651-b1d6-b90a6d923ce5" title="Eastern Conference - Finals - MIA vs BOS" round="3" outcome="win"/>
  </participant>
  <participant name="Nuggets" seed="1" record="4">
    <team id="583ed102-fb46-11e1-82cb-f4ce4684ea4c" name="Nuggets" alias="DEN" market="Denver" reference="1610612743"/>
    <source id="79030c40-c3e0-4c01-9692-af0d7ce97a45" title="Western Conference - Finals - LAL vs DEN" round="3" outcome="win"/>
  </participant>

Characters Added for Player Names

Release DateBenefit
09/16/2024

Each league-specific Basketball API will now display player names containing special characters and diacritical markings. The change aims to ensure an accurate representation of a player’s given name.

Going forward, player names such as Davis Bertans (id: c1bb78ed-4ce7-4e8c-b30c-06f8148d550a) will change to Dāvis Bertāns in each API endpoint.

Ensure that your systems can handle these special characters and diacritics.

Some examples of player names with special characters include:
  • Luka Dončić
  • Dāvis Bertāns
  • Ömer Aşık
  • Nikola Ðurišić.
Return Samples
{
  "id": "d2ee92e9-3e72-45eb-b156-2dc5adc1e6f7",
  "status": "ACT",
  "full_name": "Luka Dončić",
  "first_name": "Luka",
  "last_name": "Dončić",
  "abbr_name": "L.Dončić",
  "height": 79,
  "weight": 230,
  "position": "F-G",
  "primary_position": "PG",
  "jersey_number": "77",
  "experience": "6",
  "birth_place": "Ljubljana,, SVN",
  "birthdate": "1999-02-28",
  "updated": "2024-09-16T12:56:48Z",
  "sr_id": "sr:player:926008",
  "rookie_year": 2018,
  "reference": "1629029",
  "draft": {
    "team_id": "583ecb8f-fb46-11e1-82cb-f4ce4684ea4c",
    "year": 2018,
    "round": "1",
    "pick": "3"
  }
},
<player id="d2ee92e9-3e72-45eb-b156-2dc5adc1e6f7" status="ACT" full_name="Luka Dončić"
        first_name="Luka" last_name="Dončić" abbr_name="L.Dončić" height="79" weight="230"
        position="F-G" primary_position="PG" jersey_number="77" experience="6" birth_place="Ljubljana,, SVN"
        birthdate="1999-02-28" updated="2024-09-16T12:56:48Z" sr_id="sr:player:926008" rookie_year="2018"
        reference="1629029">

New On-Demand Simulations

Release DateBenefit
09/09/2024

We’re happy to announce expanded on-demand support for REST and push Simulations. This offering allows you to replay select games at your convenience.

How it works:

Request a list of available recordings by league.

For a normal GET game feed:

  • Register a session for the game feed(s) you are interested in playing back.

  • Start your session on your schedule – no more waiting for simulated games to start at a predefined time.

  • Continually call the endpoint for updates as one would during a live game.

For the Push feeds, simply subscribe to the recording and watch the data come through like it would during a live game.

No API Key is needed to use the simulations.

Please note that Legacy Simulations will be retired in early November.

For more details, see our Simulations page including code snippets for how to set up your calls.


📘

Earlier updates

Older updates are listed in the Change Log Archive.

Updated 20 days ago

Did this page help you?

Updated 20 days ago

Did this page help you?

© Sportradar AG, St. Gallen, Switzerland