--- title: "Fantasy Defense Season Stats - All" method: GET path: "/v3/nfl/stats/{format}/FantasyDefenseBySeason/{season}" tags: ["NFL v3 Stats"] --- # Fantasy Defense Season Stats - All `GET /v3/nfl/stats/{format}/FantasyDefenseBySeason/{season}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/nfl/stats/{format}/FantasyDefenseBySeason/{season}` - 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 season for the fantasy defense team (not IDP.) ## Path parameters - `format` 'JSON' | 'XML', required - `season` string, required ## Response `200` Success - FantasyDefenseSeason[] - `SeasonType` integer: The type of season that this team corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star) - `Season` integer: The NFL regular season for which these totals apply - `Team` string, nullable: The abbreviation [Key] of the team - `PointsAllowed` number: Total points allowed by the team during the season - `TouchdownsScored` number: Total defensive and special teams touchdowns scored by the team in the season - `SoloTackles` number: Total defensive solo (unassisted) tackles by the team in the season - `AssistedTackles` number: Total defensive assisted tackles by the team in the season - `Sacks` number: Total defensive sacks by the team in the season - `SackYards` number: Total defensive sack yards by the team in the season - `PassesDefended` number: Total passes defended by the team in the season - `FumblesForced` number: Total fumbles forced on defense by the team in the season - `FumblesRecovered` number: Total defensive fumble recoveries by the team in the season - `FumbleReturnYards` number: Total fumble return yards by the team in the season - `FumbleReturnTouchdowns` number: Total fumble return touchdowns by the team in the season - `Interceptions` number: Total defensive interceptions by the team in the season - `InterceptionReturnYards` number: Total defensive interception return yards by the team in the season - `InterceptionReturnTouchdowns` number: Total defensive interception return touchdowns by the team in the season - `BlockedKicks` number: Total blocked kicks by the team in the season. Note: BlockedKicks include Field Goals and Punts but NOT Extra Points - `Safeties` number: Total defensive safeties scored by the team in the season - `PuntReturns` number: Total punt returns by the team in the season - `PuntReturnYards` number: Total punt return yards by the team in the season - `PuntReturnTouchdowns` number: Total punt return touchdowns by the team in the season - `PuntReturnLong` number: The longest punt return by the team in the season - `KickReturns` number: Total kickoff returns by the team in the season - `KickReturnYards` number: Total kickoff return yards by the team in the season - `KickReturnTouchdowns` number: Total kickoff return touchdowns by the team in the season - `KickReturnLong` number: Longest kick return by the team in the season - `BlockedKickReturnTouchdowns` number, nullable: Total blocked kick recovery return touchdowns for the team in the season - `FieldGoalReturnTouchdowns` number, nullable: Total field goal return touchdowns by the team in the season. 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 season - `RunningbackFantasyPointsAllowed` number, nullable: Total fantasy points allowed to opposing running backs by the team in the season - `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 season - `KickerFantasyPointsAllowed` number, nullable: Fantasy points allowed to opponent kickers by the team in the season - `Games` integer, nullable: The total number of games played by the team in the season - `BlockedKickReturnYards` number, nullable: Total blocked kick recovery return yards for the team in the season - `FieldGoalReturnYards` number, nullable: Total field goal return yards by the team in the season. Note: This field excludes blocked field goals - `QuarterbackHits` number, nullable: Total quarterback hits by the team in the season. Note: This is a defensive stat that includes sacks - `TacklesForLoss` number, nullable: Total tackles for loss by the team in the season. Note: these are tackles behind the line of scrimmage for loss of yards (including sacks) - `DefensiveTouchdowns` number, nullable: Total defensive touchdowns scored by the team in the season - `SpecialTeamsTouchdowns` number, nullable: Total special teams touchdowns scored by the team in the season - `FantasyPoints` number, nullable: Fantasy points scored based on basic fantasy scoring system by the team in the season - `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 season - `ThirdDownConversions` number, nullable: Total third down conversions against the team in the season - `FourthDownAttempts` number, nullable: Opponent's fourth down attempts against the team in the season - `FourthDownConversions` number, nullable: Opponent's fourth down conversions against the team in the season - `PointsAllowedByDefenseSpecialTeams` number, nullable: Total number of points allowed by the team in the season to the opposing offense and special teams. Note: This field excludes points scored by the opponent's defense - `AuctionValue` number, nullable: Player's dollar value in a $200 salary cap auction draft. - `AuctionValuePPR` number, nullable: Player's dollar value in a $200 salary cap PPR auction draft. - `TwoPointConversionReturns` number, nullable: Total successful two point conversion returns by the team in the season - `FantasyPointsFanDuel` number, nullable: Fantasy points based on FanDuel's scoring system by the team in the season - `FantasyPointsDraftKings` number, nullable: Fantasy points based on DraftKings' scoring system by the team in the season - `OffensiveYardsAllowed` number, nullable: Offensive yards allowed by the team's defense in the season - `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 season - `AverageDraftPosition` number, nullable: The average draft position of the team's fantasy defense (DST) in re-draft leagues - `AverageDraftPositionPPR` number, nullable: The average draft position of the team (DST) in Points Per Reception (PPR) leagues - `TeamID` integer, nullable: The unique ID of the team - `GlobalTeamID` integer, nullable: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues - `FanDuelFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed to opposing offensive players in the season. Note: positions include: QB; RB; WR; TE - `FanDuelQuarterbackFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed by the team to opposing quarterbacks in the season - `FanDuelRunningbackFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed by the team to opposing running backs in the season - `FanDuelWideReceiverFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed by the team to opposing wide receivers in the season - `FanDuelTightEndFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed by the team to opposing tight ends in the season - `FanDuelKickerFantasyPointsAllowed` number, nullable: FanDuel fantasy points allowed by the team to opposing kickers in the season - `DraftKingsFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed to opposing offensive players in the season. Note: positions include: QB; RB; WR; TE - `DraftKingsQuarterbackFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed by the team to opponent quarterbacks in the season - `DraftKingsRunningbackFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed by the team to opponent running backs in the season - `DraftKingsWideReceiverFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed by the team to opponent wide receivers in the season - `DraftKingsTightEndFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed by the team to opponent tight ends in the season - `DraftKingsKickerFantasyPointsAllowed` number, nullable: DraftKings fantasy points allowed by the team to opponent kickers in the season - `YahooFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing offensive players by the team in the season. Note: Offensive players include: QB, RB, WR, & TE - `YahooQuarterbackFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing quarterbacks by the team in the season - `YahooRunningbackFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing running backs by the team in the season - `YahooWideReceiverFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing wide receivers by the team in the season - `YahooTightEndFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing tight ends by the team in the season - `YahooKickerFantasyPointsAllowed` number, nullable: Total Yahoo fantasy points allowed to opposing kickers by the team in the season - `FantasyPointsFantasyDraft` number, nullable: Fantasy points based on FanDraft's scoring system by the team in the season - `FantasyDraftFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed to opposing offensive players in the season. Note: positions include: QB; RB; WR; TE - `FantasyDraftQuarterbackFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed by the team to opposing quarterbacks in the season - `FantasyDraftRunningbackFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed by the team to opposing running backs in the season - `FantasyDraftWideReceiverFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed by the team to opposing wide receivers in the season - `FantasyDraftTightEndFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed by the team to opposing tight ends in the season - `FantasyDraftKickerFantasyPointsAllowed` number, nullable: FantasyDraft fantasy points allowed by the team to opposing kickers in the season - `ScoringDetails` ScoringDetail[]: The details of the scoring plays this team DST recorded in the season - `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 - `AverageDraftPositionDynasty` number, nullable: The average draft position of this team (DST) in dynasty drafts leagues - `AverageDraftPosition2QB` number, nullable: The average draft position of the team (DST) in 2 Quarterback leagues ## 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)