NFL Daily Change Log provides IDs and timestamps for teams, players, game statistics, schedules, and results that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Update FrequencyTTL / 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
Data Points
Change Log
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
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 |
last_modified | games - schedule - game | dateTime | Timestamp of a change to a game's scheduling information ex. 2022-09-25T23:00:45+00:00 |
last_modified | games - results - game | dateTime | Timestamp of a change to a game's results ex. 2022-09-25T23:00:45+00:00 |
last_modified | profiles - players - player | dateTime | Timestamp of a change to a player ex. 2022-09-25T22:54:34+00:00 |
last_modified | profiles - teams - team | dateTime | Timestamp of a change to a team profile ex. 2022-09-25T21:32:05+00:00 |
League
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | league | String | Alias of a league ex. NFL |
id | league | GUID | Unique ID of a league ex. 3c6d318a-6164-4290-9bbc-bf9bb21cc4b8 |
name | league | String | Name of a league ex. National Football League |
Games & Results
The games element contains two child elements, schedule and results. A game appearing under schedule indicates a change to that game's scheduling information; a game appearing under results indicates a change to that game's results. Both use the same attributes.
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | game | GUID | Unique ID of a game ex. 056b4eb7-64ce-4858-bae7-f3701d8eb753 |
season_id | game | GUID | Unique ID of the season the game belongs to ex. f5aa580e-8103-4ff5-beb0-965dbe8a8cf1 |
sr_id | game | String | Unique Sportradar ID of a game ex. sr:match:33623325 |
last_modified | game | dateTime | Timestamp of the change to the game ex. 2022-09-25T23:00:45+00:00 |
Deleted Games
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 |
Player Profiles
A player appearing under profiles - players indicates that player's profile changed during the change log window.
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | player | GUID | Unique ID of a player ex. fcfa9d4b-3e09-46ac-b4b6-77d70a5f304c |
full_name | player | String | Full name of a player ex. Marcus Johnson |
last_modified | player | dateTime | Timestamp of the change to the player ex. 2022-09-25T22:54:34+00:00 |
Team Profiles
A team appearing under profiles - teams indicates that team's profile changed during the change log window.
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | team | GUID | Unique ID of a team ex. 82d2d380-3834-4938-835f-aec541e5ece7 |
alias | team | String | Team alias ex. MIN (Minnesota) |
market | team | String | Team market name ex. Minnesota |
name | team | String | Team name ex. Vikings |
sr_id | team | String | Unique Sportradar ID of a team ex. sr:competitor:4324 |
last_modified | team | dateTime | Timestamp of the change to the team ex. 2022-09-25T21:32:05+00:00 |