--- title: "Team Game Stats - by Game [Final]" method: GET path: "/v3/nfl/stats/{format}/TeamGameStatsFinal/{season}/{week}" tags: ["NFL v3 Stats"] --- # Team Game Stats - by Game \[Final\] `GET /v3/nfl/stats/{format}/TeamGameStatsFinal/{season}/{week}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/nfl/stats/{format}/TeamGameStatsFinal/{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 the box score statistical record team-wide (aggregated from all players) for a given team's game in a given week after the game has concluded. ## Path parameters - `format` 'JSON' | 'XML', required - `season` string, required - `week` string, required ## Response `200` Success - TeamGame[] - `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 - `Date` string, nullable: The date and time of the game (in US Eastern Time) - `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 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). For seasons prior to 2021 there will be 3 preseason weeks - `Team` string, nullable: The abbreviation [Key] of the team - `Opponent` string, nullable: The abbreviation [Key] of the opponent team - `HomeOrAway` string, nullable: Whether the team is home or away - `Score` integer: The final score of the team in the game - `OpponentScore` integer: The final score of the opponent team in the game - `TotalScore` integer: The total points scored by both teams in the game - `Stadium` string, nullable: Stadium of the event - `PlayingSurface` string, nullable: The playing surface of the stadium - `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) - `OverUnder` number, nullable: The total points line (over/under) for the team in the game - `PointSpread` number, nullable: The oddsmaker point spread at game start from the perspective of the team (negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored) - `ScoreQuarter1` integer, nullable: Points scored during Quarter 1 for the team in the game - `ScoreQuarter2` integer, nullable: Points scored during Quarter 2 for the team in the game - `ScoreQuarter3` integer, nullable: Points scored during Quarter 3 for the team in the game - `ScoreQuarter4` integer, nullable: Points scored during Quarter 4 for the team in the game - `ScoreOvertime` integer: Points scored during overtime for the team in the game - `TimeOfPossessionMinutes` integer, nullable: Total time of possession (minutes) by the team in the game - `TimeOfPossessionSeconds` integer, nullable: Total time of possession (seconds) by the team in the game - `TimeOfPossession` string, nullable: Total time of possession by the team in the game - `FirstDowns` integer, nullable: Total first downs by the team in the game - `FirstDownsByRushing` integer, nullable: Total rushing first downs by the team in the game - `FirstDownsByPassing` integer, nullable: Total passing first downs by the team in the game - `FirstDownsByPenalty` integer, nullable: Total first downs by opponent's penalty by the team in the game - `OffensivePlays` integer: Number of offensive plays run by the team in the game - `OffensiveYards` integer: Total offensive yards gained by the team in the game - `OffensiveYardsPerPlay` number: Average yards gained per offensive play by the team in the game - `Touchdowns` integer, nullable: Total touchdowns scored by the team in the game - `RushingAttempts` integer, nullable: Total rushing attempts by the team in the game - `RushingYards` integer, nullable: Total rushing yards by the team in the game - `RushingYardsPerAttempt` number: Total rushing yards per attempt by the team in the game - `RushingTouchdowns` integer, nullable: Total rushing touchdowns by the team in the game - `PassingAttempts` integer, nullable: Total passes thrown by the team in the game - `PassingCompletions` integer, nullable: Total passes completed by the team in the game - `PassingYards` integer, nullable: Total passing yards by the team in the game - `PassingTouchdowns` integer, nullable: Total passing touchdowns by the team in the game - `PassingInterceptions` integer, nullable: Total interceptions thrown by the team in the game - `PassingYardsPerAttempt` number: Total average passing yards per attempt by the team in the game - `PassingYardsPerCompletion` number: Total average passing yards per completion by the team in the game - `CompletionPercentage` number: The date and time of the game (in US Eastern Time) - `PasserRating` number, nullable: The team's passer rating in the game - `ThirdDownAttempts` integer, nullable: Total third down attempts by the team in the game - `ThirdDownConversions` integer, nullable: Total percentage of third downs converted by the team in the game - `ThirdDownPercentage` number, nullable: Percentage of third downs converted - `FourthDownAttempts` integer, nullable: Total fourth down attempts by the team in the game - `FourthDownConversions` integer, nullable: Total fourth down conversions by the team in the game - `FourthDownPercentage` number, nullable: Percentage of fourth downs converted by the team in the game - `RedZoneAttempts` integer, nullable: Total red zone opportunities by the team in the game - `RedZoneConversions` integer, nullable: Total red zone opportunities converted into touchdowns by the team in the game - `GoalToGoAttempts` integer, nullable: This field is deprecated - `GoalToGoConversions` integer, nullable: This field is deprecated - `ReturnYards` integer, nullable: Total punt and defensive return yards by the team in the game - `Penalties` integer, nullable: Total penalties committed by the team in the game - `PenaltyYards` integer, nullable: Total penalty yards enforced against the team - `Fumbles` integer, nullable: Total fumbles by the team in the game - `FumblesLost` integer, nullable: Total fumbles lost by the team in the game - `TimesSacked` integer, nullable: Total number of sacks allowed by the team in the game - `TimesSackedYards` integer, nullable: Total sack yards allowed by the team in the game - `QuarterbackHits` integer, nullable: Total quarterback hits by the team in the game. Note: This is a defensive stat that includes sacks - `TacklesForLoss` integer, 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) - `Safeties` integer, nullable: Total defensive safeties scored by the team in the game - `Punts` integer, nullable: Total number of punts by the team in the game - `PuntYards` integer, nullable: Total punt yards by the team in the game - `PuntAverage` number: The average number of yards per punt by the team in the game - `Giveaways` integer: Total number of giveaways by the team in the game - `Takeaways` integer: Total takeaways by the team in the game - `TurnoverDifferential` integer: Total turnover differential (takeaways minus giveaways) by the team in the game - `OpponentScoreQuarter1` integer, nullable: Points scored during Quarter 1 for the opponent team in the game - `OpponentScoreQuarter2` integer, nullable: Points scored during Quarter 2 for the opponent team in the game - `OpponentScoreQuarter3` integer, nullable: Points scored during Quarter 3 for the opponent team in the game - `OpponentScoreQuarter4` integer, nullable: Points scored during Quarter 4 for the opponent team in the game - `OpponentScoreOvertime` integer: Points scored during overtime for the opponent team in the game - `OpponentTimeOfPossessionMinutes` integer, nullable: Total time of possession minutes for the opponent team in the game - `OpponentTimeOfPossessionSeconds` integer, nullable: Total time of possession seconds for the opponent team in the game - `OpponentTimeOfPossession` string, nullable: Total time of possession for the opponent team in the game - `OpponentFirstDowns` integer, nullable: Total first downs converted by the opponent team in the game - `OpponentFirstDownsByRushing` integer, nullable: Total rushing first downs by the opponent team in the game - `OpponentFirstDownsByPassing` integer, nullable: Total passing first downs converted by the opponent team in the game - `OpponentFirstDownsByPenalty` integer, nullable: Total first downs by penalty for the opponent team in the game - `OpponentOffensivePlays` integer: Total offensive plays by the opponent team in the game - `OpponentOffensiveYards` integer: Total offensive yards gained by the opponent team in the game - `OpponentOffensiveYardsPerPlay` number: Average yards gained per offensive play by the opponent team in the game - `OpponentTouchdowns` integer, nullable: Total touchdowns scored by the opponent team in the game - `OpponentRushingAttempts` integer, nullable: Total rushing attempts by the opponent team in the game - `OpponentRushingYards` integer, nullable: Total rushing yards by the opponent team in the game - `OpponentRushingYardsPerAttempt` number: Average rushing yards gained per attempt by the opponent team in the game - `OpponentRushingTouchdowns` integer, nullable: Total rushing touchdowns by the opponent team in the game - `OpponentPassingAttempts` integer, nullable: Total passes thrown by the opponent team in the game - `OpponentPassingCompletions` integer, nullable: Total passing completions by the opponent team in the game - `OpponentPassingYards` integer, nullable: Total passing yards by the opponent team in the game - `OpponentPassingTouchdowns` integer, nullable: Total passing touchdowns by the opponent team in the game - `OpponentPassingInterceptions` integer, nullable: Total interceptions thrown by the opponent team in the game - `OpponentPassingYardsPerAttempt` number: Average passing yards gained per attempt by the opponent team in the game - `OpponentPassingYardsPerCompletion` number: Average passing yards gained per completion by the opponent team in the game - `OpponentCompletionPercentage` number: Total completion percentage of the opponent team in the game - `OpponentPasserRating` number, nullable: Total passer rating by the opponent team in the game - `OpponentThirdDownAttempts` integer, nullable: Total third down attempts by the opponent team in the game - `OpponentThirdDownConversions` integer, nullable: Total third down conversions by the opponent team in the game - `OpponentThirdDownPercentage` number, nullable: Total third down percentage by the opponent team in the game - `OpponentFourthDownAttempts` integer, nullable: Total fourth downs attempted by the opponent team in the game - `OpponentFourthDownConversions` integer, nullable: Total fourth downs converted by the opponent team in the game - `OpponentFourthDownPercentage` number, nullable: Total fourth down conversion percentage by the opponent team in the game - `OpponentRedZoneAttempts` integer, nullable: Total red zone opportunities by the opponent team in the game - `OpponentRedZoneConversions` integer, nullable: Total red zone opportunities converted to touchdowns by the opponent team in the game - `OpponentGoalToGoAttempts` integer, nullable: This field is deprecated - `OpponentGoalToGoConversions` integer, nullable: This field is deprecated - `OpponentReturnYards` integer, nullable: Total punt and defensive return yards by the opponent team in the game - `OpponentPenalties` integer, nullable: Total penalties enforced against the opponent team in the game - `OpponentPenaltyYards` integer, nullable: Total penalty yards enforced against the opponent team in the game - `OpponentFumbles` integer, nullable: Total offensive fumbles by the opponent team in the game - `OpponentFumblesLost` integer, nullable: Total fumbles lost by the opponent team in the game - `OpponentTimesSacked` integer, nullable: Total sacks allowed by the opponent team in the game - `OpponentTimesSackedYards` integer, nullable: Total yards as a result of a sack allowed by the opponent team in the game - `OpponentQuarterbackHits` integer, nullable: Total quarterback hits by the opponent team in the game - `OpponentTacklesForLoss` integer, nullable: Total tackles for loss by the opponent team in the game - `OpponentSafeties` integer, nullable: Total safeties recorded by the opponent team in the game - `OpponentPunts` integer, nullable: Total punts by the opponent team in the game - `OpponentPuntYards` integer, nullable: Total punt yards by the opponent team in the game - `OpponentPuntAverage` number: Average number of yards per punt - `OpponentGiveaways` integer: Total giveaways by the opponent team in the game - `OpponentTakeaways` integer: Total takeaways by the opponent team in the game - `OpponentTurnoverDifferential` integer: Total turnover differential by the opponent team in the game (takeaways minus giveaways) - `RedZonePercentage` number, nullable: Total percentage of red zone opportunities converted into touchdowns by the team in the game - `GoalToGoPercentage` number, nullable: This field is deprecated - `QuarterbackHitsDifferential` integer, nullable: The quarterback hits differential of the team in the game. Note: Determined by hits on opposing quarterback minus hits on own quarterback - `TacklesForLossDifferential` integer, nullable: Total tackles for loss differential by the team in the game - `QuarterbackSacksDifferential` integer: Total sack differential of the team in the game - `TacklesForLossPercentage` number, nullable: Total percentage of plays defended that resulted in a tackle for loss by the team in the game - `QuarterbackHitsPercentage` number, nullable: Total percentage of opposing quarterback dropbacks that resulted in a quarterback hit by the team in the game - `TimesSackedPercentage` number: Total percentage of drop backs that resulted in a sack by the team in the game - `OpponentRedZonePercentage` number, nullable: Percentage of opponent's red zone opportunities converted into touchdowns in the game - `OpponentGoalToGoPercentage` number, nullable: This field is deprecated - `OpponentQuarterbackHitsDifferential` integer, nullable: Total quarterback hits differential by the opponent team in the game - `OpponentTacklesForLossDifferential` integer, nullable: Total tackles for loss differential by the opponent team in the game - `OpponentQuarterbackSacksDifferential` integer, nullable: Total quarterback sacks differential by the opponent team in the game - `OpponentTacklesForLossPercentage` number, nullable: Total percentage of tackles for loss by the opponent team in the game - `OpponentQuarterbackHitsPercentage` number, nullable: Total quarterback hits percentage by the opponent team in the game - `OpponentTimesSackedPercentage` number: Total percentage of dropbacks that resulted in a sack allowed by the opponent team in the game - `Kickoffs` integer, nullable: Total number of kickoffs by the team in the game - `KickoffsInEndZone` integer, nullable: Total kickoffs that went into the end zone by the team in the game - `KickoffTouchbacks` integer, nullable: Total kickoffs that resulted in touchbacks by the team in the game - `PuntsHadBlocked` integer, nullable: Total punts by the team that were blocked in the game - `PuntNetAverage` number, nullable: The average net yards per punt by the team in the game - `ExtraPointKickingAttempts` integer, nullable: Total extra point kick attempts by the team in the game - `ExtraPointKickingConversions` integer, nullable: Total extra point kicks made by the team in the game - `ExtraPointsHadBlocked` integer, nullable: Total extra point kick attempts by the team that were blocked in the game - `ExtraPointPassingAttempts` integer, nullable: Total two point conversions passing conversions by the team in the game - `ExtraPointPassingConversions` integer, nullable: Total two point conversions passing conversions by the team in the game - `ExtraPointRushingAttempts` integer, nullable: Total two point conversion rushing attempts by the team in the game - `ExtraPointRushingConversions` integer, nullable: Total two point conversion rushing conversions in the game - `FieldGoalAttempts` integer, nullable: Total field goal attempts by the team in the game - `FieldGoalsMade` integer, nullable: Total field goals made by the team in game - `FieldGoalsHadBlocked` integer, nullable: Total field goals by the team that were blocked in the game - `PuntReturns` integer, nullable: Total punt returns by the team in the game - `PuntReturnYards` integer, nullable: Total punt return yards by the team in the game - `KickReturns` integer, nullable: Total kickoff returns by the team in the game - `KickReturnYards` integer, nullable: Total kickoff return yards by the team in the game - `InterceptionReturns` integer, nullable: Total defensive interception returns by the team in the game - `InterceptionReturnYards` integer, nullable: Total defensive interception return yards by the team in the game - `OpponentKickoffs` integer, nullable: Total kickoffs by the opponent team in the game - `OpponentKickoffsInEndZone` integer, nullable: Total kickoffs that went into the end zone by the opponent team in the game - `OpponentKickoffTouchbacks` integer, nullable: Total kickoffs that resulted in touchbacks by the opponent team in the game - `OpponentPuntsHadBlocked` integer, nullable: Total punt yard that were blocked for the opponent team in the game - `OpponentPuntNetAverage` number, nullable: This field is deprecated - `OpponentExtraPointKickingAttempts` integer, nullable: Total extra point kick attempts by the opponent team in the game - `OpponentExtraPointKickingConversions` integer, nullable: Total extra point kicks made by the opponent team in the game - `OpponentExtraPointsHadBlocked` integer, nullable: Total extra point kick attempts that were blocked against the opponent team in the game - `OpponentExtraPointPassingAttempts` integer, nullable: Total two point conversion passing attempts by the opponent team in the game - `OpponentExtraPointPassingConversions` integer, nullable: Total two point conversion passing conversions by the opponent team in the game - `OpponentExtraPointRushingAttempts` integer, nullable: Total two point conversion rushing attempts by the opponent team in the game - `OpponentExtraPointRushingConversions` integer, nullable: Total two point conversion rushing conversions by the opponent team in the game - `OpponentFieldGoalAttempts` integer, nullable: Total field goal attempts by the opponent team in the game - `OpponentFieldGoalsMade` integer, nullable: Total field goals made by the opponent team in the game - `OpponentFieldGoalsHadBlocked` integer, nullable: Total blocked field goals against the opponent team in the game - `OpponentPuntReturns` integer, nullable: Total punt returns by the opponent team in the game - `OpponentPuntReturnYards` integer, nullable: Total punt return yards by the opponent team in the game - `OpponentKickReturns` integer, nullable: Total kickoff returns by the opponent team in the game - `OpponentKickReturnYards` integer, nullable: Total kickoff return yards by the opponent team in the game - `OpponentInterceptionReturns` integer, nullable: Total defensive interceptions by the opponent team in the game - `OpponentInterceptionReturnYards` integer, nullable: Total defensive interception return yards by the opponent team in the game - `SoloTackles` integer, nullable: Total defensive solo (unassisted) tackles by the team in the game - `AssistedTackles` integer, nullable: Total defensive assisted tackles by the team in the game - `Sacks` integer, nullable: Total defensive sacks by the team in the game - `SackYards` integer, nullable: Total defensive sack yards by the team in the game - `PassesDefended` integer, nullable: Total passes defended by the team's defense in the game - `FumblesForced` integer, nullable: Total fumbles forced on defense by the team in the game - `FumblesRecovered` integer, nullable: Total defensive fumble recoveries by the team in the game - `FumbleReturnYards` integer, nullable: Total fumble return yards by the team in the game - `FumbleReturnTouchdowns` integer, nullable: Total fumble return touchdowns by the team in the game - `InterceptionReturnTouchdowns` integer, nullable: Total defensive interception return touchdowns by the team in the game - `BlockedKicks` integer, nullable: Total blocked kicks by the team in the game. Note: BlockedKicks include Field Goals and Punts but NOT Extra Points - `PuntReturnTouchdowns` integer, nullable: Total punt return touchdowns by the team in the game - `PuntReturnLong` integer, nullable: The longest punt return by the team in the game - `KickReturnTouchdowns` integer, nullable: Total kickoff return touchdowns by the team in the game - `KickReturnLong` integer, nullable: Longest kick return by the team in the game - `BlockedKickReturnYards` integer, nullable: Total blocked kick recovery return yards for the team in the game - `BlockedKickReturnTouchdowns` integer, nullable: Total blocked kick recovery return touchdowns for the team in the game - `FieldGoalReturnYards` integer, nullable: Total field goal return yards by the team in the game. Note: This field excludes blocked field goals - `FieldGoalReturnTouchdowns` integer, nullable: Total field goal return touchdowns by the team in the game. Note: This field excludes blocked field goals - `PuntNetYards` integer, nullable: The net yards of the punts by the team in the game - `OpponentSoloTackles` integer, nullable: Total defensive solo tackles by the opponent team in the game - `OpponentAssistedTackles` integer, nullable: Total defensive assisted tackles by the opponent team in the game - `OpponentSacks` integer, nullable: Total defensive sacks by the opponent team in the game - `OpponentSackYards` integer, nullable: Total defensive sack yards by the opponent team in the game - `OpponentPassesDefended` integer, nullable: Total passes defended by the opponent team in the game - `OpponentFumblesForced` integer, nullable: Total defensive fumbles forced by the opponent team in the game - `OpponentFumblesRecovered` integer, nullable: Total defensive fumble recoveries by the opponent team in the game - `OpponentFumbleReturnYards` integer, nullable: Total defensive fumbles return yards by the opponent team in the game - `OpponentFumbleReturnTouchdowns` integer, nullable: Total defensive fumbles return touchdowns by the opponent team in the game - `OpponentInterceptionReturnTouchdowns` integer, nullable: Total defensive interception touchdowns by the opponent team in the game - `OpponentBlockedKicks` integer, nullable: Total blocked kicks against the opponent team in the game - `OpponentPuntReturnTouchdowns` integer, nullable: Total punt return touchdowns by the opponent team in the game - `OpponentPuntReturnLong` integer, nullable: Longest punt return by the opponent team in the game - `OpponentKickReturnTouchdowns` integer, nullable: Total kickoff return touchdowns by the opponent team in the game - `OpponentKickReturnLong` integer, nullable: Longest kick return by the opponent team in the game - `OpponentBlockedKickReturnYards` integer, nullable: Total blocked kick return yards by the opponent team in the game - `OpponentBlockedKickReturnTouchdowns` integer, nullable: Total blocked kick return touchdowns by the opponent team in the game - `OpponentFieldGoalReturnYards` integer, nullable: Total field goal return yards by the opponent team in the game. Note: Excludes blocked field goals (only for straight misses that are returned) - `OpponentFieldGoalReturnTouchdowns` integer, nullable: Total field goal return touchdowns by the opponent team in the game. Note: Excludes blocked field goals (only for straight misses that are returned) - `OpponentPuntNetYards` integer, nullable: This field is deprecated - `IsGameOver` boolean, nullable: Whether the game is over (true/false) - `TeamName` string, nullable: The full name of the team (e.g. New England Patriots; Los Angeles Chargers) - `DayOfWeek` string, nullable: The day of the week this game was played on (e.g. Sunday; Monday; Thursday) - `PassingDropbacks` integer, nullable: Total number of times the team dropped back to pass in the game - `OpponentPassingDropbacks` integer, nullable: Total passing dropbacks by the opponent team in the game - `TeamGameID` integer: Unique ID of this TeamGame record (subject to change; although it very rarely does). For a guaranteed static ID; use a combination of GameKey and Team. - `PointDifferential` integer, nullable: The team's total point differential in the game - `PassingInterceptionPercentage` number, nullable: The team's percentage of passes that were intercepted by the defense in the game. Note: This refers to the offensive team's passes that were intercepted - `PuntReturnAverage` number, nullable: The average punt return yardage for the team in the game - `KickReturnAverage` number, nullable: Average kick return yards by the team in the game - `ExtraPointPercentage` number, nullable: Team's percentage of extra points made in the game - `FieldGoalPercentage` number, nullable: Team's percentage of field goals made in the game - `OpponentPassingInterceptionPercentage` number, nullable: Percentage of passes that were intercepted against the opponent team in the game - `OpponentPuntReturnAverage` number, nullable: Punt return average of the opponent team in the game - `OpponentKickReturnAverage` number, nullable: Kick return average of the opponent team in the game - `OpponentExtraPointPercentage` number, nullable: Total extra point percentage by the opponent team in the game - `OpponentFieldGoalPercentage` number, nullable: Total field goal percentage by the opponent team in the game - `PenaltyYardDifferential` integer, nullable: The team's penalty yard differential in the game - `PuntReturnYardDifferential` integer, nullable: Punt return yard differential for the team in the game - `KickReturnYardDifferential` integer, nullable: Total kick return yard differential by the team in the game - `TwoPointConversionReturns` integer, nullable: Total successful two point conversion returns by the team in the game - `OpponentTwoPointConversionReturns` integer, nullable: Total two point attempt returns converted by the defense for the opponent team in the game - `TeamID` integer, nullable: The unique ID of this team - `OpponentID` integer, nullable: Total defensive interceptions by the opponent team in the game - `Day` string, nullable: The date of the game (in US Eastern Time) - `DateTime` string, nullable: The date 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 - `ScoreID` integer: Unique ID of the score/game ## 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)