NFL Game Roster provides complete game roster information for each team, including game status and player profile data.
Update FrequencyTTL / Cache: This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.
Data Updates: Realtime
Data Points
Boxscore:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attendance | game | Integer | Attendance of a game ex. 73242 |
remaining_challenges | away | Integer | Away team challenges remaining |
remaining_timeouts | away | Integer | Away team timeouts remaining |
used_challenges | away | Integer | Away team challenges used |
used_timeouts | away | Integer | Away team timeouts used |
points | away | Integer | Away team total points |
clock | game | String | Clock value of the game ex. 12:37 |
remaining_challenges | home | Integer | Home team challenges remaining |
remaining_timeouts | home | Integer | Home team timeouts remaining |
used_challenges | home | Integer | Home team challenges used |
used_timeouts | home | Integer | Home team timeouts used |
points | home | Integer | Home team total points |
quarter | game | Integer | Quarter number of the game |
Officials:
Attribute | Parent Element | Type | Description |
---|---|---|---|
assignment | official | String | Official assignment ex. linejudge or replayofficial |
id | official | GUID | Unique ID of an official ex. 77980520-3898-11ee-b2de-574aa938ad02 |
full_name | official | String | Full name of an official ex. Brad Rogers |
number | official | Integer | Jersey number of an official |
Draft:
Attribute | Parent Element | Type | Description |
---|---|---|---|
number | draft | Integer | Draft pick number of a player |
round | draft | Integer | Draft pick round of a player |
year | draft | Integer | Draft year of a player |
alias | draft - team | String | Draft team alias ex. MIN (Minnesota) |
id | draft - team | GUID | Unique ID of a draft team ex. 82d2d380-3834-4938-835f-aec541e5ece7 |
market | draft - team | String | Draft team market name ex. Minnesota |
name | draft - team | String | Draft team name ex. Vikings |
sr_id | draft - team | String | Unique Sportradar ID of a draft team ex. sr:competitor:4324 |
Game:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| String | Away team alias |
|
| GUID | Unique ID of the away team |
|
| String | Away team market name |
|
| String | Away team name |
|
| String | Unique Sportradar ID of the away team |
|
| String | Name of a game's internet stream |
|
| String | Name of a game's broadcast network |
|
| String | Name of a game's radio station |
|
| String | Name of a game's broadcast satellite station |
|
| Boolean | Signifies an in-Conference matchup |
|
| String | Duration of the game |
|
| String | Type of data entry for the game |
|
| String | Type of game |
|
| String | Home team alias |
|
| GUID | Unique ID of the home team |
|
| String | Home team market name |
|
| String | Home team name |
|
| String | Unique Sportradar ID of the home team |
|
| GUID | Unique ID of a game |
|
| Boolean | Signifies a game is held at a neutral site |
|
| Integer | Game number |
|
| GUID | Standard parent ID of a game. Use this ID to group events (like the Super Bowl) across seasons. |
|
| Date/Time | Scheduled date and time of a game |
|
| String | Unique Sportradar ID of a game |
|
| String | Game status |
|
| String | Game title |
|
| String | Time zone of the away team |
|
| String | Time zone of the home team |
|
| String | Time zone of the venue |
|
| String | Weather condition for a game |
|
| Byte | Humidity conditions for a game |
|
| Byte | Temperature of a game in Fahrenheit |
|
| String | Wind direction for a game |
|
| Byte | Wind speed for a game in MPH |
League:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | season | GUID | Unique season ID 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 week ID ex. 57b447ce-bc66-47f7-9760-89d328d3db9f |
sequence | week | Integer | Week sequence number |
title | week | String | Week title |
Player:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| String | Abbreviated name of a player |
|
| Integer | Age of a player at the time of the game |
|
| Date | Player date of birth |
|
| String | Birthplace of a player |
|
| String | College attended |
|
| String | College Conference |
|
| String | First name of a player |
|
| String | Full name of a player |
|
| Integer | Height in inches |
|
| String | High school attended |
|
| GUID | Unique ID of a player |
|
| String | In-game status of a player updated in real-time |
|
| Integer | Jersey number of a player |
|
| String | Last name of a player |
|
| String | Suffix of a player |
|
| String | Position of a player |
|
| String | Preferred name of a player |
|
| GUID | Unique Sportradar ID of a player |
|
| String | Game status of a player |
|
| Decimal | Weight in lbs |
Standings:
Team win-loss-tie data is added after a game moves to
complete
status. It is not present prior to or during a game.
Attribute | Parent Element | Type | Description |
---|---|---|---|
losses | record | Integer | Number of team losses year-to-date after a game |
ties | record | Integer | Number of team ties year-to-date after a game |
wins | record | Integer | Number of team wins year-to-date after a game |
Coaches:
Attribute | Parent Element | Type | Description |
---|---|---|---|
first_name | home / away - coach | String | First name of a coach ex. Dennis |
full_name | home / away - coach | String | Full name of a coach ex. Dennis Allen |
id | home / away - coach | GUID | Unique ID of a coach ex. ef1b4704-0ce4-4977-a882-2b14413dd2d2 |
last_name | home / away - coach | String | Last name of a coach ex. Allen |
name_suffix | home / away - coach | String | Suffix of a coach ex. Jr. |
position | home / away - coach | String | Type of coach ex. Head Coach or Offensive Coordinator |
Team:
Attribute | Parent Element | Type | Description |
---|---|---|---|
alias | team | String | Team alias ex. MIN (Minnesota) |
id | team | GUID | Unique ID of a team ex. 82d2d380-3834-4938-835f-aec541e5ece7 |
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 |
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 |