Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Current Season Schedule

NFL Current Season Schedule provides schedule information for the current season, including venue and broadcast info, and scoring results by quarter.

⏱️

Update Frequency

TTL / Cache: 10 seconds

Data Updates: Hourly.

A new season begins on the date of the first game of a season.

Use this feed for non-live schedule retrieval only.



Data Points

Boxscore:
AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game
ex. 73242
away_pointsscoringIntegerAway team total points
away_pointsscoring - quarterIntegerAway team points in a quarter
away_pointsscoring - overtimeIntegerAway team points in overtime
home_pointsscoringIntegerHome team total points
home_pointsscoring - quarterIntegerHome team points in a quarter
home_pointsscoring - overtimeIntegerHome team points in overtime
idscoring - overtimeGUIDUnique ID of overtime
numberscoring - overtimeIntegerOvertime number (The first overtime played would be 1)
sequencescoring - overtimeIntegerPeriod sequence number (The first overtime sequence would be 5)
idscoring - quarterGUIDUnique ID of a quarter
ex. 47091cc4-08c2-4f83-9d8d-59c3c85e1725
numberscoring - quarterIntegerQuarter number
sequencescoring - quarterIntegerPeriod 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 game
LDE (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.
ex. f6c2b12d-966c-41a5-98a7-054620fba38b (Super Bowl)

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, unnecessary

See 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 condition for a game
ex. Partly cloudy, Clear, Light Rain, Mist

Click here for more info on weather condition values

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):
AttributeParent ElementTypeDescription
namegame - awayStringAway 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)
aliasgame - awayStringAway 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)
namegame - homeStringHome 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)
aliasgame - homeStringHome 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)
coveragegame - away / home - sourceStringCoverage level of a previous (source) playoff matchup
full
game_typegame - away / home - sourceStringType of game of a previous (source) playoff matchup
regular, playoff
idgame - away / home - sourceGUIDUnique game ID of the of a previous (source) playoff matchup
ex. 11845229-fffb-4fb1-bab6-ec276fb56447
outcomegame - away / home - sourceStringOutcome of a previous (source) playoff matchup
ex. win
scheduledgame - away / home - sourcedateTimeScheduled date and time of a previous (source) playoff matchup
ex. 2023-03-21T23:00:00+00:00
statusgame - away / home - sourceStringGame status of a previous (source) playoff matchup
ex. closed
titlegame - away / home - sourceStringGame title of a previous (source) playoff matchup
ex. NFC Championship
League:
AttributeParent ElementTypeDescription
aliasbye_week - teamStringBye team alias
ex. MIN (Minnesota)
idbye_week - teamGUIDUnique ID of the bye team
ex. 768c92aa-75ff-4a43-bcc0-f2798c2e1724
namebye_week - teamStringBye team full name
ex. Minnesota Vikings
sr_idbye_week - teamGUIDUnique Sportradar ID of the bye team
ex. sr:competitor:4376
idseasonGUIDUnique ID of a season
ex. 75749c10-56c1-4ae0-9d1e-2689708debdf
nameseasonStringName of the season
PRE, REG, PST
typeseasonStringType of the season
PRE, REG, PST
yearseasonIntegerYear of the season
idweekGUIDUnique ID of a week
ex. 57b447ce-bc66-47f7-9760-89d328d3db9f
sequenceweekIntegerWeek sequence number
titleweekStringWeek title
Venue:
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue
ex. 900 S 5th Street
capacityvenueIntegerCapacity of a venue
ex. 72220
cityvenueStringCity of a venue
ex. Minneapolis
countryvenueStringCountry of a venue
ex. USA
idvenueGUIDUnique ID of a venue
ex. 6a72e5ca-33d0-40af-8e6b-b32a4d3d9346
latvenue - locationDecimalLatitude of a venue
ex. 29.684735
lngvenue - locationDecimalLongitude of a venue
ex. -95.410725
namevenueStringName of a venue
ex. U.S. Bank Stadium
roof_typevenueStringRoof type of a venue
outdoor, dome, retractable_dome
sr_idvenueStringUnique Sportradar venue ID
ex. sr:venue:2402
statevenueStringState of a venue
ex. MN
surfacevenueStringSurface type of a venue
turf, artificial
zipvenueIntegerZIP code of a venue
ex. 77054
Language
Credentials
Header
Click Try It! to start a request and see the response here!