---
title: "Projected Fantasy Defense Game Stats With DFS Salaries"
method: GET
path: "/v3/nfl/projections/{format}/FantasyDefenseProjectionsByGame/{season}/{week}"
tags: ["NFL v3 Projections"]
---

# Projected Fantasy Defense Game Stats With DFS Salaries

`GET /v3/nfl/projections/{format}/FantasyDefenseProjectionsByGame/{season}/{week}`

## Request

- Base URL: `https://api.sportsdata.io`
- URL: `https://api.sportsdata.io/v3/nfl/projections/{format}/FantasyDefenseProjectionsByGame/{season}/{week}`
- Auth: one of:
  - API key in header `Ocp-Apim-Subscription-Key`
  - API key in query parameter `key`
- TypeScript: <https://skmtc.dev/sportsdata/apis/nfl-api/docs/v3/nfl/projections/:format/FantasyDefenseProjectionsByGame/:season/:week/get.ts> (a function with typed inputs; its response is checked against the schema)

SportsDataIO's proprietary projections, including DFS salary information, for all fantasy defense teams. Called by season and week. Does not contain Individual Defensive Players (IDP), which have their own endpoint.

## Path parameters

- `format` 'JSON' | 'XML', required
- `season` string, required
- `week` string, required

## Response `200`

Success

- FantasyDefenseGameProjection[]
  - `GameKey` string, nullable: A 9 digit unique code identifying the game that this record corresponds to. The GameID is composed of Season; SeasonType; Week and HomeTeam. Note: This value will be NULL for bye weeks
  - `SeasonType` integer: The type of season that this player corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
  - `Season` integer: The NFL season of the game
  - `Week` integer, nullable: The NFL week of the game (regular season: 1 to 18; preseason: 0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3 preseason weeks
  - `Date` string, nullable: The date and time of the game (in US Eastern Time)
  - `Team` string, nullable: The abbreviation [Key] of the team
  - `Opponent` string, nullable: The abbreviation [Key] of the opponent team
  - `PointsAllowed` number: Total points allowed by the team during the game
  - `TouchdownsScored` number: Total defensive and special teams touchdowns scored by the team in the game
  - `SoloTackles` number: Total defensive solo (unassisted) tackles by the team in the game
  - `AssistedTackles` number: Total defensive assisted tackles by the team in the game
  - `Sacks` number: Total defensive sacks by the team in the game
  - `SackYards` number: Total defensive sack yards by the team in the game
  - `PassesDefended` number: Total passes defended by the team in the game
  - `FumblesForced` number: Total fumbles forced on defense by the team in the game
  - `FumblesRecovered` number: Total defensive fumble recoveries by the team in the game
  - `FumbleReturnYards` number: Total fumble return yards by the team in the game
  - `FumbleReturnTouchdowns` number: Total fumble return touchdowns by the team in the game
  - `Interceptions` number: Total defensive interceptions by the team in the game
  - `InterceptionReturnYards` number: Total defensive interception return yards by the team in the game
  - `InterceptionReturnTouchdowns` number: Total defensive interception return touchdowns by the team in the game
  - `BlockedKicks` number: Total blocked kicks by team in the game. Note: BlockedKicks include Field Goals and Punts but NOT Extra Points
  - `Safeties` number: Total defensive safeties scored by the team in the game
  - `PuntReturns` number: Total punt returns by the team in the game
  - `PuntReturnYards` number: Total punt return yards by the team in the game
  - `PuntReturnTouchdowns` number: Total punt return touchdowns by the team in the game
  - `PuntReturnLong` number: The longest punt return by the team in the game
  - `KickReturns` number: Total kickoff returns by the team in the game
  - `KickReturnYards` number: Total kickoff return yards by the team in the game
  - `KickReturnTouchdowns` number: Total kickoff return touchdowns by the team in the game
  - `KickReturnLong` number: Longest kick return by the team in the game
  - `BlockedKickReturnTouchdowns` number, nullable: Total blocked kick recovery return touchdowns for the team in the game
  - `FieldGoalReturnTouchdowns` number, nullable: Total field goal return touchdowns by the team in the game. Note: This field excludes blocked field goals
  - `FantasyPointsAllowed` number, nullable: Fantasy points allowed to opposing offensive players in the season. Note: positions include: QB; RB; WR; TE
  - `QuarterbackFantasyPointsAllowed` number, nullable: Fantasy points allowed to opposing quarterbacks by the team in the game
  - `RunningbackFantasyPointsAllowed` number, nullable: Total fantasy points allowed to opposing running backs by the team in the game
  - `WideReceiverFantasyPointsAllowed` number, nullable: Fantasy points allowed to opposing wide receivers
  - `TightEndFantasyPointsAllowed` number, nullable: Fantasy points allowed to opposing tight ends by the team in the game
  - `KickerFantasyPointsAllowed` number, nullable: Fantasy points allowed to opponent kickers by the team in the game
  - `BlockedKickReturnYards` number, nullable: Total blocked kick recovery return yards for the team in the game
  - `FieldGoalReturnYards` number, nullable: Total field goal return yards by the team in the game. Note: This field excludes blocked field goals
  - `QuarterbackHits` number, nullable: Total quarterback hits by the team in the game. Note: This is a defensive stat that includes sacks
  - `TacklesForLoss` number, nullable: Total tackles for loss by the team in the game. Note: These are tackles behind the line of scrimmage for loss of yards (including sacks)
  - `DefensiveTouchdowns` number, nullable: Total touchdowns scored by the defense
  - `SpecialTeamsTouchdowns` number, nullable: Total special teams touchdowns scored by the team in the game
  - `IsGameOver` boolean, nullable: Whether the game is over (true/false)
  - `FantasyPoints` number, nullable: Fantasy points scored based on basic fantasy scoring system by the team's D/ST in the game
  - `Stadium` string, nullable: Stadium of the event
  - `Temperature` integer, nullable: Temperature at game start (Fahrenheit)
  - `Humidity` integer, nullable: The humidity percentage at the start of the game
  - `WindSpeed` integer, nullable: The wind speed at the start of the game (in MPH)
  - `ThirdDownAttempts` number, nullable: Total third down attempts against the team in the game
  - `ThirdDownConversions` number, nullable: Total third down conversions against the team in the game
  - `FourthDownAttempts` number, nullable: Opponent's fourth down attempts against the team in the game
  - `FourthDownConversions` number, nullable: Opponent's fourth down conversions against the team in the game
  - `PointsAllowedByDefenseSpecialTeams` number, nullable: Total number of points allowed by the team in the game to the opposing offense and special teams. Note: This field excludes points scored by the opponent's defense
  - `FanDuelSalary` integer, nullable: The team's D/ST salary for FanDuel daily fantasy contests
  - `DraftKingsSalary` integer, nullable: The team's D/ST salary for DraftKings daily fantasy contests.
  - `FantasyDataSalary` integer, nullable: The team's D/ST salary as calculated by SportsDataIO (formerly known as FantasyData). Based on the same salary cap as DraftKings contests ($50,000)
  - `VictivSalary` integer, nullable: The player's salary for Victiv daily fantasy contests.
  - `TwoPointConversionReturns` number, nullable: Total successful two point conversion returns by the team in the game
  - `FantasyPointsFanDuel` number, nullable: Fantasy points based on FanDuel's scoring system by the team in the game
  - `FantasyPointsDraftKings` number, nullable: Fantasy points based on DraftKings' scoring system by the team in the game
  - `OffensiveYardsAllowed` number, nullable: Offensive yards allowed by the team's defense in the game
  - `YahooSalary` integer, nullable: The player's salary for Yahoo daily fantasy contests
  - `PlayerID` integer, nullable: The unique PlayerID of the player as assigned by SportsDataIO for use when combining with player feeds. Note: this ID will stay with the player throughout their entire career
  - `FantasyPointsYahoo` number, nullable: Fantasy points based on Yahoo's daily fantasy scoring system by the team in the game
  - `HomeOrAway` string, nullable: Whether the team is home or away
  - `OpponentRank` integer, nullable: The ranking of the opposing team's offense with regards to fantasy points allowed to fantasy DST
  - `OpponentPositionRank` integer, nullable: The ranking of the opposing team's offense with regards to fantasy points allowed to fantasy DST
  - `FantasyDraftSalary` integer, nullable: The team's D/ST salary for FantasyDraft daily fantasy contests.
  - `TeamID` integer, nullable: The unique ID of the team
  - `OpponentID` integer, nullable: The unique ID of this opponent team
  - `Day` string, nullable: The date of the game (in US Eastern Time)
  - `DateTime` string, nullable: The date and time of the game (in US Eastern Time)
  - `GlobalGameID` integer, nullable: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues
  - `GlobalTeamID` integer, nullable: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues
  - `GlobalOpponentID` integer, nullable: A globally unique ID for this team's opponent. This value is guaranteed to be unique across all sports/leagues
  - `DraftKingsPosition` string, nullable: The position of this team's D/ST; as listed by DraftKings.
  - `FanDuelPosition` string, nullable: The position of this team's D/ST; as listed by FanDuel.
  - `FantasyDraftPosition` string, nullable: The position of this team's D/ST; as listed by FantasyDraft
  - `YahooPosition` string, nullable: The position of the team's defense/special teams unit, as listed on Yahoo's daily fantasy sports platform
  - `FantasyDefenseID` integer, nullable: "Unique ID of FantasyDefense record (subject to change; although it very rarely does). Note: For a guaranteed static ID; use a combination of GameKey and Team"
  - `ScoreID` integer: Unique ID of the score/game
  - `FanDuelFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed to opposing offensive players in the game. Note: positions include: QB; RB; WR; TE
  - `FanDuelQuarterbackFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed by the team to opposing quarterbacks in the game
  - `FanDuelRunningbackFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed by the team to opposing running backs in the game
  - `FanDuelWideReceiverFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed by the team to opposing wide receivers in the game
  - `FanDuelTightEndFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed by the team to opposing tight ends in the game
  - `FanDuelKickerFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed by the team to opposing kickers in the game
  - `DraftKingsFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed to opposing offensive players in the game. Note: positions include: QB; RB; WR; TE
  - `DraftKingsQuarterbackFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed by the team to opponent quarterbacks in the game
  - `DraftKingsRunningbackFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed by the team to opponent running backs in the game
  - `DraftKingsWideReceiverFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed by the team to opponent wide receivers in the game
  - `DraftKingsTightEndFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed by the team to opponent tight ends in the game
  - `DraftKingsKickerFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed to opposing kickers
  - `YahooFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing offensive players by the team in the game. Note: Offensive players include: QB, RB, WR, & TE
  - `YahooQuarterbackFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing quarterbacks by the team in the game
  - `YahooRunningbackFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing running backs by the team in the game
  - `YahooWideReceiverFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing wide receivers by the team in the game
  - `YahooTightEndFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing tight ends by the team in the game
  - `YahooKickerFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing kickers by the team in the game
  - `FantasyPointsFantasyDraft` number, nullable: Fantasy points based on FantasyDraft's scoring system by the team in the game
  - `FantasyDraftFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed to opposing offensive players in the game. Note: positions include: QB; RB; WR; TE
  - `FantasyDraftQuarterbackFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed by the team to opposing quarterbacks in the game
  - `FantasyDraftRunningbackFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed by the team to opposing running backs in the game
  - `FantasyDraftWideReceiverFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed by the team to opposing wide receivers in the game
  - `FantasyDraftTightEndFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed by the team to opposing tight ends in the game
  - `FantasyDraftKickerFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed by the team to opposing kickers in the game
  - `ScoringDetails` ScoringDetail[]: The details of the scoring plays this team DST recorded in the game
    - `GameKey` string, nullable: A 9 digit unique code identifying the game that this record corresponds to. The GameID is composed of Season; SeasonType; Week and HomeTeam. Note: This value will be NULL for bye weeks
    - `SeasonType` integer: The type of season that this game corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)
    - `PlayerID` integer, nullable: The unique PlayerID of the player as assigned by SportsDataIO tied to this scoring detail. Note: this ID will stay with the player throughout their entire career
    - `Team` string, nullable: The abbreviation [Key] of the team
    - `Season` integer: The season during which the score happened
    - `Week` integer: The NFL week of the game (regular season: 1 to 18; preseason: 0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3 preseason weeks
    - `ScoringType` string, nullable: The type of scoring play (e.g. BlockedFieldGoalReturnTouchdown, BlockedPuntReturnTouchdown, FieldGoalMade, FieldGoalReturnTouchdown, FumbleReturnTouchdown, InterceptionReturnTouchdown, KickoffReturnTouchdown, PassingTouchdown, PuntReturnTouchdown, ReceivingTouchdown, RushingTouchdown, Safety)
    - `Length` integer: The length in yards of the score
    - `ScoringDetailID` integer: Unique ID of this scoring detail
    - `PlayerGameID` integer: Unique ID of the PlayerGame record tied to this scoring detail
    - `ScoreID` integer, nullable: Unique ID of the score/game
    - `ScoringPlayID` integer, nullable: Unique ID of the scoring play

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/sportsdata/apis/nfl-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/nfl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/nfl-api/revisions/2dca8b6e9675?raw)
