GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

NHL API – Deleted Games

We've added support for deleted games in version 7 of the NHL API.

Previously, deleted games were fully removed from the API. Now, when a game is removed from our coverage (for example, a duplicate or erroneously created game), it will remain available with:

  • "deleted": true at the game level
  • A "deleted_games" array within Schedule endpoints
  • A deleted_games node added to the Daily Change Log feed

Benefit

Track and store deleted game IDs within your system to prevent mis-categorization or unintended downstream processing.


📋 Recommended Actions

  • Update your Schedule and Daily Change Log ingestion to read the new deleted flag and deleted_games array/node.
  • Store deleted game IDs so your system can suppress or reconcile them, rather than treating a previously-valid game as still active.
  • Confirm your downstream processing (stats, standings, displays) excludes games flagged as deleted.

☑️ Sample Requests:

Season Schedule

curl --request GET \
     --url https://api.sportradar.com/nhl/trial/v7/en/games/{season_year}/{season_type}/schedule.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

Daily Change Log

curl --request GET \
     --url https://api.sportradar.com/nhl/trial/v7/en/league/{year}/{month}/{day}/changes.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

SportProductVersion(s)
Ice HockeyNHL APIv7

🔁 Endpoints Affected

  • Daily Change Log
  • Game Boxscore, Game Faceoffs, Game Play-by-Play, Game Shot Zones, Game Summary, Game Time on Ice
  • Daily Schedule, Season Schedule

⚙️ Return Samples

{
  "id": "3c10d26b-2c58-4a33-9faa-37d57b999054",
  "status": "scheduled",
  "coverage": "full",
  "scheduled": "2026-08-18T00:00:00+00:00",
  "deleted": true,
  "is_all_star_game": false,
  "is_outdoors": false,
  "season": {
    "id": "4a67cca6-b450-45f9-91c6-48e92ac19069",
    "year": 2025,
    "type": "REG",
    "name": "Regular Season"
  },
  "venue": {
    "id": "1ea58cb6-6a28-4619-b010-747ecbc30aa7",
    "name": "Lenovo Center",
    "capacity": 18680,
    "address": "1400 Edwards Mill Road",
    "city": "Raleigh",
    "state": "NC",
    "zip": "27607",
    "country": "USA",
    "time_zone": "US/Eastern",
    "reference": "612",
    "location": {
      "latitude": "35.80345079214118",
      "longitude": "-78.72182325990354"
    }
  },
  "time_zones": {
    "venue": "US/Eastern",
    "home": "US/Eastern",
    "away": "US/Central"
  },
  "home": {
    "full_name": "Carolina Hurricanes",
    "alias": "CAR",
    "reference": "12",
    "game_number": 84,
    "id": "44182a9d-0f24-11e2-8525-18a905767e44",
    "market": "Carolina",
    "name": "Hurricanes",
    "points": 0
  },
  "away": {
    "full_name": "Chicago Blackhawks",
    "alias": "CHI",
    "reference": "16",
    "game_number": 83,
    "id": "4416272f-0f24-11e2-8525-18a905767e44",
    "market": "Chicago",
    "name": "Blackhawks",
    "points": 0
  }
}
{
    "league": {
      "id": "fd560107-a85b-4388-ab0d-655ad022aff7",
      "name": "NHL",
      "alias": "NHL"
    },
    "season": {
      "id": "4a67cca6-b450-45f9-91c6-48e92ac19069",
      "year": 2025,
      "type": "REG"
    },
    "games": [
      {
        "id": "72e5d52b-84ae-43f4-bb8c-e8d3975c9979",
        "status": "scheduled",
        "coverage": "full",
        "reference": "20897",
        "scheduled": "2026-02-05T02:00:00+00:00",
        "season": {
          "id": "4a67cca6-b450-45f9-91c6-48e92ac19069",
          "year": 2025,
          "type": "REG"
        },
        "venue": {
          "id": "a75eea49-c384-4edb-99f1-d5252773ec83",
          "name": "Ball Arena",
          "capacity": 18007,
          "city": "Denver",
          "state": "CO",
          "country": "USA",
          "time_zone": "US/Mountain"
        },
        "home": {
          "name": "Colorado Avalanche",
          "alias": "COL",
          "id": "4415ce44-0f24-11e2-8525-18a905767e44"
        },
        "away": {
          "name": "San Jose Sharks",
          "alias": "SJ",
          "id": "44155909-0f24-11e2-8525-18a905767e44"
        }
      }
      // ... additional games omitted for brevity ...
    ],
    "deleted_games": [
      {
        "id": "3c10d26b-2c58-4a33-9faa-37d57b999054"
      },
      {
        "id": "b3fec6f9-e454-4f7b-ab74-96750e097748"
      }
    ]
  }