STAT-API

Pre-game injuries vs. the full week (mode=pre|full)

Some NFL values change after kickoff: a Questionable player gets hurt in the game and is ruled Out on Monday. stat-api keeps the kickoff value and the later value apart. mode=pre (the default) returns each value as it stood at its own game's kickoff. mode=full returns the latest value before week end, the first Tuesday 04:00 ET after the game. Train and back-test on PRE; read FULL for the full story of the week.

  1. 1. Read the injury report as it stood at kickoff

    No mode parameter means PRE. The envelope says which mode served the rows, and so does the X-Time-Wall-Mode header.

    curl -sS \
      -H 'Authorization: Bearer YOUR_API_KEY' \
      'https://api.stat-api.com/api/v1/nfl/injuries?game_id=43445'
    
  2. 2. Read the full week

    mode=full adds every change seen after kickoff and before week end, including players first listed after the game started.

    curl -sS \
      -H 'Authorization: Bearer YOUR_API_KEY' \
      'https://api.stat-api.com/api/v1/nfl/injuries?game_id=43445&mode=full'
    
  3. 3. Game rosters and slate players work the same way

    nfl/game_team_rosters (status, injury status, depth, starter) and dfs/slate_players (operator injury code, details, average points) take the same parameter. Each DFS player locks at his own game's kickoff, as in late swap.

    curl -sS \
      -H 'Authorization: Bearer YOUR_API_KEY' \
      'https://api.stat-api.com/api/v1/dfs/slate_players?slate_id=129036&mode=full'
    
  4. 4. Post-game fields need FULL

    In PRE, the actual_* columns of nfl/projected_player_snaps and nfl/projected_team_snaps are null, and dfs/slate_players with enrich=dfs.player_stats returns 400, because fantasy points exist only after the game. Add mode=full to read them.

    curl -sS \
      -H 'Authorization: Bearer YOUR_API_KEY' \
      'https://api.stat-api.com/api/v1/dfs/slate_players?slate_id=129036&enrich=dfs.player_stats&mode=full'
    
  5. 5. Which endpoints take mode

    The five tables above (injuries, game_team_rosters, slate_players, projected_player_snaps, projected_team_snaps) and the DFS slate projections, roster-context and injuries views. Depth charts, lines and props hold only pre-kickoff captures. Box scores, play-by-play, participation, weather and contest results are post-game data. Any other table returns 400 on mode. The Data timing guide in the SDK docs has the full NFL week timeline.