GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

Basketball APIs – Deleted Games, All-Star Flag, and Estimated Return Date

We've added support for deleted games across our basketball APIs, plus an All-Star Game flag (NBA, WNBA) and an estimated return date for injuries (NBA, WNBA). All changes are in version 8, in JSON and XML.

  • deleted: true when a game has been removed from coverage (for example, a duplicate or erroneously created game). The flag is present only when true. NBA, WNBA, NCAA Men's Basketball, NCAA Women's Basketball, NBA G League, Unrivaled.
  • deleted_games: an array of removed game IDs in each league's Schedule endpoint.
  • is_all_star_game: true on All-Star games in the Schedule endpoint, and absent on every other game. NBA and WNBA.
  • estimated_return_date: the date a player is expected to return from injury, on each injury in the Injuries and Daily Injuries endpoints. Optional; present when an estimate is available. NBA and WNBA.

⭐ Benefit

Keep stored game IDs valid without re-ingesting the full schedule, label All-Star games without matching on titles, and show expected availability alongside a player's injury status.


📋 Recommended Actions

  • Drop any stored game ID that appears in deleted_games, and exclude games flagged deleted from statistics, standings, and displays.
  • Read is_all_star_game from the Schedule endpoint to label or filter All-Star games.
  • Treat estimated_return_date as optional and show it next to the injury status when present.

☑️ Sample Requests:

curl --request GET \
     --url https://api.sportradar.com/nba/trial/v8/en/games/2025/REG/schedule.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'
curl --request GET \
     --url https://api.sportradar.com/nba/trial/v8/en/league/injuries.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'
curl --request GET \
     --url https://api.sportradar.com/ncaamb/trial/v8/en/games/2fb08fff-22e8-47f3-98f6-a4940174e210/summary.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

SportProductVersion(s)
BasketballNBA APIv8
BasketballWNBA APIv8
BasketballNCAA Men's Basketball APIv8
BasketballNCAA Women's Basketball APIv8
BasketballNBA G League APIv8
BasketballUnrivaled APIv8

🔁 Endpoints Affected

  • Schedule, Daily Schedule, Game Boxscore, Game Summary, Game Play-by-Play (deleted; all six leagues)
  • Schedule (deleted_games; all six leagues) and (is_all_star_game; NBA, WNBA)
  • Injuries, Daily Injuries, Team Profile (estimated_return_date; NBA, WNBA)

⚙️ Return Samples

Return Samples
{
  "id": "2fb08fff-22e8-47f3-98f6-a4940174e210",
  "status": "time-tbd",
  "coverage": "full",
  "scheduled": "2027-02-05T18:00:00+00:00",
  "deleted": true,
  "season": {
    "id": "c000147f-6286-4eab-a89b-4c501661188f",
    "year": 2026,
    "type": "REG",
    "name": "Regular Season"
  },
  "home": {
    "name": "Spartans",
    "alias": "MSU",
    "market": "Michigan State",
    "id": "a41d5a05-4c11-4171-a57e-e7a1ea325a6d"
  },
  "away": {
    "name": "Fighting Illini",
    "alias": "ILL",
    "market": "Illinois",
    "id": "150148c2-ca8f-414f-8f41-d94a55d4a122"
  }
}
{
  "id": "2c858e82-1761-4274-a6e0-700a0ff8f8fd",
  "status": "closed",
  "title": "2026 NBA All-Star Round Robin - Game 1",
  "coverage": "full",
  "scheduled": "2026-02-15T22:00:00+00:00",
  "is_all_star_game": true,
  "home": {
    "name": "Stars",
    "alias": "STR",
    "id": "ec6c3e11-8b5f-4f71-af10-07a04685cc0d"
  },
  "away": {
    "name": "World",
    "alias": "WLD",
    "id": "2787dac8-2baf-4237-b382-8ad0c73dcab9"
  }
}
{
  "id": "9e6b42b8-8e8f-4715-b095-074b54d4d8ca",
  "comment": "The Clippers said on Wednesday (Aug. 26) that Miller repaired a torn left rotator cuff and will be re-evaluated in six months, per Law Murray of The Athletic.",
  "desc": "Shoulder",
  "status": "Out",
  "start_date": "2026-08-26",
  "update_date": "2026-08-26",
  "estimated_return_date": "2027-03-01"
}