---
updatedAt: 2026-08-18T17:55:03.000Z
agentTools:
siteIndex: https://developer.sportradar.com/llms.txt
projectIndex: https://developer.sportradar.com/ice-hockey/llms.txt
---
# Daily Change Log
**NHL Daily Change Log** provides IDs and timestamps for teams, players, game statistics, schedules, and standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.
### Update Frequency
**TTL / Cache:**
* 15 minutes for current day
* 1 hour for current month
* 4 hours for current year
* 12 hours for past years
**Data Updates**:
* Entries populate live for changes to teams, players, game statistics, schedules, and standings.
* Start time of the log is _05:00:00 UTC_; end time is _04:59:59 UTC_
> 📘 Monitoring Daily Updates
>
> Learn how to use the Daily Change Log to track updates without exhausting your API quota in our [Track NHL API Updates](https://developer.sportradar.com/hockey/docs/ig-tracking-nhl-api-updates) integration scenario.
***
## Data Points
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `last_modified` | `schedule` / `results` - `game` | dateTime | Timestamp of a change to a game
ex. `2022-09-25T23:00:45+00:00` |
| `last_modified` | `player` | dateTime | Timestamp of a change to a player
ex. `2022-09-25T22:54:34+00:00` |
| `last_modified` | `team` | dateTime | Timestamp of a change to a team
ex. `2022-2022-09-25T21:32:05+00:00` |
| `season_id` | `game` | GUID | Unique ID of a season
ex. `5d08ca09-ec49-4559-9c0f-257c0158e57f` |
| `start_time` | `changelog` | dateTime | Start time of the daily change log
ex. `2022-09-25T09:00:00+00:00` |
| `end_time` | `changelog` | dateTime | End time of the daily change log
ex. `2022-09-26T08:59:58+00:00` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `alias` | `league` | String | Alias of a league
ex. `NHL` |
| `id` | `league` | GUID | Unique ID of a league
ex. `fd560107-a85b-4388-ab0d-655ad022aff7` |
| `name` | `league` | String | Name of a league
ex. `NHL` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `game` | GUID | Unique ID of a game
ex. `11d58fa9-c32b-40c0-86e2-b1ded25b4bf9` |
| `reference` | `game` | Number | League reference ID of a game
ex. `20402` |
| `sr_id` | `game` | GUID | Unique Sportradar ID of a game
ex. `sr:match:34542761` |
| `title` | `game` | String | Title of a game
ex. `Game 3` |
The `deleted_games` element is a sibling of `changelog` (not nested within it) and appears only when one or more games were removed from the schedule during the change log window. Each `game` entry lists a removed game by ID only.
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `deleted_games` - `game` | GUID | Unique ID of a game that was removed from the schedule
ex. `056b4eb7-64ce-4858-bae7-f3701d8eb753` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `full_name` | `player` | String | Full name of a player
ex. `Sidney Crosby` |
| `id` | `player` | GUID | Unique ID of a player
ex. `433de553-0f24-11e2-8525-18a905767e44` |
| `reference` | `player` | String | League reference ID of a player
ex. `9` |
| `sr_id` | `player` | GUID | Unique Sportradar ID of a player
ex. `sr:player:31007` |
| Attribute | Parent Element | Type | Description |
| --------- | -------------- | ---- | ----------- |
| `id` | `team` | GUID | Unique ID of a team
ex. `4415b0a7-0f24-11e2-8525-18a905767e44` |
| `market` | `team` | String | Market name of a team
ex. `Ottawa` |
| `name` | `team` | String | Name of a team
ex. `Senators` |
| `reference` | `team` | String | League reference ID of a team
ex. `9` |
| `sr_id` | `team` | GUID | Unique Sportradar ID of a team
ex. `sr:team:3700` |
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "nhl",
"version": "7"
},
"servers": [
{
"url": "https://api.sportradar.com/nhl/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/{access_level}/v7/{language_code}/league/{year}/{month}/{day}/changes.{format}": {
"get": {
"summary": "Daily Change Log",
"description": "**NHL Daily Change Log** provides IDs and timestamps for teams, players, game statistics, schedules, and standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.",
"operationId": "nhl-daily-change-log",
"parameters": [
{
"name": "access_level",
"in": "path",
"description": "The access level of your API key
`trial`, `production`",
"schema": {
"type": "string",
"enum": [
"trial",
"production"
],
"default": "trial"
},
"required": true
},
{
"name": "language_code",
"in": "path",
"description": "2-letter code for supported languages
`br` (Brazilian Portuguese), `en` (English), `es` (Spanish), `fr` (French), `ru` (Russian), `zh` (Simplified Chinese",
"schema": {
"type": "string",
"enum": [
"br",
"en",
"es",
"fr",
"ru",
"zh"
],
"default": "en"
},
"required": true
},
{
"name": "year",
"in": "path",
"description": "Year in `YYYY` format",
"schema": {
"type": "string",
"enum": [
"2013",
"2014",
"2015",
"2016",
"2017",
"2018",
"2019",
"2020",
"2021",
"2022",
"2023",
"2024",
"2025",
"2026"
],
"default": "2025"
},
"required": true
},
{
"name": "month",
"in": "path",
"description": "Month in `MM` format",
"schema": {
"type": "string",
"enum": [
"01",
"02",
"03",
"04",
"05",
"06",
"07",
"08",
"09",
"10",
"11",
"12"
],
"default": "01"
},
"required": true
},
{
"name": "day",
"in": "path",
"description": "Date in `DD` format",
"schema": {
"type": "string",
"enum": [
"01",
"02",
"03",
"04",
"05",
"06",
"07",
"08",
"09",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"28",
"29",
"30",
"31"
],
"default": "06"
},
"required": true
},
{
"name": "format",
"in": "path",
"description": "Format returned
`json`, `xml`",
"schema": {
"type": "string",
"enum": [
"json",
"xml"
],
"default": "json"
},
"required": true
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"league\": {\n \"id\": \"fd560107-a85b-4388-ab0d-655ad022aff7\",\n \"name\": \"NHL\",\n \"alias\": \"NHL\"\n },\n \"start_time\": \"2022-12-05T05:00:00Z\",\n \"end_time\": \"2022-12-06T04:59:59Z\",\n \"players\": [\n {\n \"id\": \"099beb40-4306-4b6e-ac6d-73a5864c28f4\",\n \"full_name\": \"Zac Dalpe\",\n \"last_modified\": \"2022-12-05T20:56:18Z\",\n \"sr_id\": \"sr:player:137572\",\n \"reference\": \"8474610\"\n }\n\n ],\n \"schedule\": [\n {\n \"id\": \"11d58fa9-c32b-40c0-86e2-b1ded25b4bf9\",\n \"season_id\": \"5d08ca09-ec49-4559-9c0f-257c0158e57f\",\n \"last_modified\": \"2022-12-06T03:38:43Z\",\n \"sr_id\": \"sr:match:34542761\",\n \"reference\": \"20402\"\n }\n ],\n \"results\": [\n {\n \"season_id\": \"5d08ca09-ec49-4559-9c0f-257c0158e57f\",\n \"id\": \"cdbc2786-c7a4-40fe-b7e7-9e3c567ae83c\",\n \"last_modified\": \"2022-12-05T16:09:14Z\",\n \"sr_id\": \"sr:match:34542749\",\n \"reference\": \"20396\"\n }\n ],\n \"standings\": [\n {\n \"id\": \"44182a9d-0f24-11e2-8525-18a905767e44\",\n \"name\": \"Hurricanes\",\n \"market\": \"Carolina\",\n \"last_modified\": \"2022-12-05T13:45:49Z\",\n \"sr_id\": \"sr:team:3680\",\n \"reference\": \"12\"\n }\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"league": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "fd560107-a85b-4388-ab0d-655ad022aff7"
},
"name": {
"type": "string",
"example": "NHL"
},
"alias": {
"type": "string",
"example": "NHL"
}
}
},
"start_time": {
"type": "string",
"example": "2022-12-05T05:00:00Z"
},
"end_time": {
"type": "string",
"example": "2022-12-06T04:59:59Z"
},
"players": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "099beb40-4306-4b6e-ac6d-73a5864c28f4"
},
"full_name": {
"type": "string",
"example": "Zac Dalpe"
},
"last_modified": {
"type": "string",
"example": "2022-12-05T20:56:18Z"
},
"sr_id": {
"type": "string",
"example": "sr:player:137572"
},
"reference": {
"type": "string",
"example": "8474610"
}
}
}
},
"schedule": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "11d58fa9-c32b-40c0-86e2-b1ded25b4bf9"
},
"season_id": {
"type": "string",
"example": "5d08ca09-ec49-4559-9c0f-257c0158e57f"
},
"last_modified": {
"type": "string",
"example": "2022-12-06T03:38:43Z"
},
"sr_id": {
"type": "string",
"example": "sr:match:34542761"
},
"reference": {
"type": "string",
"example": "20402"
}
}
}
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"season_id": {
"type": "string",
"example": "5d08ca09-ec49-4559-9c0f-257c0158e57f"
},
"id": {
"type": "string",
"example": "cdbc2786-c7a4-40fe-b7e7-9e3c567ae83c"
},
"last_modified": {
"type": "string",
"example": "2022-12-05T16:09:14Z"
},
"sr_id": {
"type": "string",
"example": "sr:match:34542749"
},
"reference": {
"type": "string",
"example": "20396"
}
}
}
},
"standings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "44182a9d-0f24-11e2-8525-18a905767e44"
},
"name": {
"type": "string",
"example": "Hurricanes"
},
"market": {
"type": "string",
"example": "Carolina"
},
"last_modified": {
"type": "string",
"example": "2022-12-05T13:45:49Z"
},
"sr_id": {
"type": "string",
"example": "sr:team:3680"
},
"reference": {
"type": "string",
"example": "12"
}
}
}
}
}
}
}
}
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```