Explanation of the different timeframes that appear in the API.
For NFL, we have a timeframes API that will dynamically return the current & upcoming weeks at any point during the NFL season (including off-season). We also provide static fields, like CurrentSeason and UpcomingWeek to dictate the current point in time of the NFL Season. However, the timeframes endpoint will provide much more meta information than just the current season & week numbers.
This is the current timeframe. This timeframe includes the 24 hour period after all NFL games end. So, if all games for the week end on Monday evening at 11:45pm EST, the timeframe flips over on Tuesday evening at 11:59pm EST (approximately 24 hours later).
This is the upcoming timeframe. This will always include the current timeframe in which games have yet to be completed. Once all games in the current timeframe have completed, this flips over to the next timeframe. For example, in a week where there is a Monday night game, the upcoming timeframe flips over to the next week as soon as the Monday night game is completed.
This is always the timeframe immediately before the upcoming timeframe. Flips over once all games in upcoming timeframe have completed.
- Recent This includes all recent and future timeframes. Any timeframe within 6 months of today's date is included.
- All This includes all timeframes dating back to 2002.
Related Help Articles
current, upcoming, completed, recent, all, period,