get https://api.sportradar.com/nfl/official//v7//games////schedule.
NFL Weekly Schedule provides complete schedule information for a given week of the season, including venue, weather conditions, broadcast info, and scoring results by quarter.
Update Frequency
TTL / Cache: 10 seconds
Data Updates: Schedule info is updated in realtime as changes are made
Data Points
Boxscore:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
attendance | game | Integer | Attendance of a game ex. 73242 |
away_points | scoring | Integer | Away team total points |
away_points | scoring - quarter | Integer | Away team points in a quarter |
away_points | scoring - overtime | Integer | Away team points in overtime |
home_points | scoring | Integer | Home team total points |
home_points | scoring - quarter | Integer | Home team points in a quarter |
home_points | scoring - overtime | Integer | Home team points in overtime |
id | scoring - overtime | GUID | Unique ID of overtime |
number | scoring - overtime | Integer | Overtime number (The first overtime played would be 1) |
sequence | scoring - overtime | Integer | Period sequence number (The first overtime sequence would be 5) |
id | scoring - quarter | GUID | Unique ID of a quarter ex. 47091cc4-08c2-4f83-9d8d-59c3c85e1725 |
number | scoring - quarter | Integer | Quarter number |
sequence | scoring - quarter | Integer | Period sequence number |
Game:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | away | String | Away team alias ex. MIN (Minnesota) |
game_number | away | Integer | Season game number for the away team |
id | away | GUID | Unique ID of the away team ex. 768c92aa-75ff-4a43-bcc0-f2798c2e1724 |
name | away | String | Away team full name ex. Minnesota Vikings |
sr_id | away | GUID | Unique Sportradar ID of the away team ex. sr:competitor:4376 |
internet | broadcast | String | Name of a game's internet stream ex. ESPN+ |
network | broadcast | String | Name of a game's broadcast network ex. Amazon Prime Video |
radio | broadcast | String | Name of a game's radio station ex. Sirius 134, XM 231 |
satellite | broadcast | String | Name of a game's broadcast satellite station ex. ESPN Ocho |
conference_game | game | Boolean | Signifies an in-Conference matchup ex. (NFC vs. NFC) |
duration | game | String | Duration of the game ex. 2:52 |
entry_mode | game | String | Type of data entry for the gameLDE (Live Data Entry) |
alias | home | String | Home team alias ex. GB (Green Bay) |
game_number | home | Integer | Season game number for the home team |
id | home | GUID | Unique ID of the home team ex. 7b112545-38e6-483c-a55c-96cf6ee49cb8 |
name | home | String | Home team full name ex. Green Bay Packers |
sr_id | home | String | Unique Sportradar ID of the home team ex. sr:competitor:4391 |
id | game | GUID | Unique ID of a game ex. 13025660-aa95-4885-b33e-3a3554d4c4c3 |
parent_id | game | GUID | Standard parent ID of a game. Use this ID to group events (like the Super Bowl) across seasons. |
scheduled | game | Date/Time | Scheduled date and time of a game ex. 2022-09-25T20:10:00+00:00 |
sr_id | game | String | Unique Sportradar ID of a game ex. sr:match:33623305 |
status | game | String | Game status scheduled, created, inprogress, complete, closed, cancelled, delayed, suspended, postponed, time-tbd, if necessary, unnecessarySee our NFL FAQ for game status descriptions |
title | game | String | Game title ex. NFC Championship |
away | time_zones | String | Time zone of the away team ex. US/Pacific |
home | time_zones | String | Time zone of the home team ex. US/Eastern |
venue | time_zones | String | Time zone of the venue ex. US/Eastern |
condition | weather | String | Weather conditions for a game ex. Partly cloudy |
humidity | weather | Byte | Humidity conditions for a game ex. 44 |
temp | weather | Byte | Temperature of a game in Fahrenheit ex. 57 |
direction | weather - wind | String | Wind direction for a game ex. N |
speed | weather - wind | Byte | Wind speed for a game in MPH |
Game (Previous Round):
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
name | game - away | String | Away team full name. Team name will populate after the source game has ended. Prior to this, the field will populate the source game title. ex. Minnesota Vikings or NFC Championship (win) (team unknown) |
alias | game - away | String | Away team alias. Team alias will populate after the source game has ended. Prior to this, the field will populate the source game title. ex. MIN or NFC Championship (win) (team unknown) |
name | game - home | String | Home team full name. Team name will populate after the source game has ended. Prior to this, the field will populate the source game title. ex. Minnesota Vikings or NFC Championship (win) (team unknown) |
alias | game - home | String | Home team alias. Team alias will populate after the source game has ended. Prior to this, the field will populate the source game title. ex. MIN or NFC Championship (win) (team unknown) |
coverage | game - away / home - source | String | Coverage level of a previous (source) playoff matchupfull |
game_type | game - away / home - source | String | Type of game of a previous (source) playoff matchupregular, playoff |
id | game - away / home - source | GUID | Unique game ID of the of a previous (source) playoff matchup ex. 11845229-fffb-4fb1-bab6-ec276fb56447 |
outcome | game - away / home - source | String | Outcome of a previous (source) playoff matchup ex. win |
scheduled | game - away / home - source | dateTime | Scheduled date and time of a previous (source) playoff matchup ex. 2023-03-21T23:00:00+00:00 |
status | game - away / home - source | String | Game status of a previous (source) playoff matchup ex. closed |
title | game - away / home - source | String | Game title of a previous (source) playoff matchup ex. NFC Championship |
League:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | bye_week - team | String | Bye team alias ex. MIN (Minnesota) |
id | bye_week - team | GUID | Unique ID of the bye team ex. 768c92aa-75ff-4a43-bcc0-f2798c2e1724 |
name | bye_week - team | String | Bye team full name ex. Minnesota Vikings |
sr_id | bye_week - team | GUID | Unique Sportradar ID of the bye team ex. sr:competitor:4376 |
id | season | GUID | Unique ID of a season ex. 75749c10-56c1-4ae0-9d1e-2689708debdf |
name | season | String | Name of the seasonPRE,REG,PST |
type | season | String | Type of the seasonPRE,REG,PST |
year | season | Integer | Year of the season |
id | week | GUID | Unique ID of a week ex. 57b447ce-bc66-47f7-9760-89d328d3db9f |
sequence | week | Integer | Week sequence number |
title | week | String | Week title |
Venue:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
address | venue | String | Address of a venue ex. 900 S 5th Street |
capacity | venue | Integer | Capacity of a venue ex. 72220 |
city | venue | String | City of a venue ex. Minneapolis |
country | venue | String | Country of a venue ex. USA |
id | venue | GUID | Unique ID of a venue ex. 6a72e5ca-33d0-40af-8e6b-b32a4d3d9346 |
lat | venue - location | Decimal | Latitude of a venue ex. 29.684735 |
lng | venue - location | Decimal | Longitude of a venue ex. -95.410725 |
name | venue | String | Name of a venue ex. U.S. Bank Stadium |
roof_type | venue | String | Roof type of a venueoutdoor,dome,retractable_dome |
sr_id | venue | String | Unique Sportradar venue ID ex. sr:venue:2402 |
state | venue | String | State of a venue ex. MN |
surface | venue | String | Surface type of a venueturf,artificial |
zip | venue | Integer | ZIP code of a venue ex. 77054 |