--- title: "Fantasy Defense Game Stats - All" method: GET path: "/v3/nfl/stats/{format}/FantasyDefenseByGame/{season}/{week}" tags: ["NFL v3 Stats"] --- # Fantasy Defense Game Stats - All `GET /v3/nfl/stats/{format}/FantasyDefenseByGame/{season}/{week}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/nfl/stats/{format}/FantasyDefenseByGame/{season}/{week}` - Auth: one of: - API key in header `Ocp-Apim-Subscription-Key` - API key in query parameter `key` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns stats and fantasy points for a given game for the fantasy defense team (not IDP.) ## Path parameters - `format` 'JSON' | 'XML', required - `season` string, required - `week` string, required ## Response `200` Success - FantasyDefenseGame[] - `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)