NFL v3 Stats

Team Game Stats - by Game [Final]

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.

get/v3/nfl/stats/{format}/TeamGameStatsFinal/{season}/{week}

Request

Path parameters

format'JSON' | 'XML' required

Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.

seasonstring required
      Year of the season and the season type. If no season type is provided, then the default is regular season.
      <br>Examples: <code>2015REG</code>, <code>2015PRE</code>, <code>2015POST</code>.
    
weekstring required
      Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.
      Example: <code>1</code>
    

Response

Success

GameKeystring 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

Datestring nullable

The date and time of the game (in US Eastern Time)

SeasonTypeinteger

The type of season that this team corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star)

Seasoninteger

The NFL season of the game

Weekinteger 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

Teamstring nullable

The abbreviation [Key] of the team

Opponentstring nullable

The abbreviation [Key] of the opponent team

HomeOrAwaystring nullable

Whether the team is home or away

Scoreinteger

The final score of the team in the game

OpponentScoreinteger

The final score of the opponent team in the game

TotalScoreinteger

The total points scored by both teams in the game

Stadiumstring nullable

Stadium of the event

PlayingSurfacestring nullable

The playing surface of the stadium

Temperatureinteger nullable

Temperature at game start (Fahrenheit)

Humidityinteger nullable

The humidity percentage at the start of the game

WindSpeedinteger nullable

The wind speed at the start of the game (in MPH)

OverUndernumber nullable

The total points line (over/under) for the team in the game

PointSpreadnumber 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)

ScoreQuarter1integer nullable

Points scored during Quarter 1 for the team in the game

ScoreQuarter2integer nullable

Points scored during Quarter 2 for the team in the game

ScoreQuarter3integer nullable

Points scored during Quarter 3 for the team in the game

ScoreQuarter4integer nullable

Points scored during Quarter 4 for the team in the game

ScoreOvertimeinteger

Points scored during overtime for the team in the game

TimeOfPossessionMinutesinteger nullable

Total time of possession (minutes) by the team in the game

TimeOfPossessionSecondsinteger nullable

Total time of possession (seconds) by the team in the game

TimeOfPossessionstring nullable

Total time of possession by the team in the game

FirstDownsinteger nullable

Total first downs by the team in the game

FirstDownsByRushinginteger nullable

Total rushing first downs by the team in the game

FirstDownsByPassinginteger nullable

Total passing first downs by the team in the game

FirstDownsByPenaltyinteger nullable

Total first downs by opponent's penalty by the team in the game

OffensivePlaysinteger

Number of offensive plays run by the team in the game

OffensiveYardsinteger

Total offensive yards gained by the team in the game

OffensiveYardsPerPlaynumber

Average yards gained per offensive play by the team in the game

Touchdownsinteger nullable

Total touchdowns scored by the team in the game

RushingAttemptsinteger nullable

Total rushing attempts by the team in the game

RushingYardsinteger nullable

Total rushing yards by the team in the game

RushingYardsPerAttemptnumber

Total rushing yards per attempt by the team in the game

RushingTouchdownsinteger nullable

Total rushing touchdowns by the team in the game

PassingAttemptsinteger nullable

Total passes thrown by the team in the game

PassingCompletionsinteger nullable

Total passes completed by the team in the game

PassingYardsinteger nullable

Total passing yards by the team in the game

PassingTouchdownsinteger nullable

Total passing touchdowns by the team in the game

PassingInterceptionsinteger nullable

Total interceptions thrown by the team in the game

PassingYardsPerAttemptnumber

Total average passing yards per attempt by the team in the game

PassingYardsPerCompletionnumber

Total average passing yards per completion by the team in the game

CompletionPercentagenumber

The date and time of the game (in US Eastern Time)

PasserRatingnumber nullable

The team's passer rating in the game

ThirdDownAttemptsinteger nullable

Total third down attempts by the team in the game

ThirdDownConversionsinteger nullable

Total percentage of third downs converted by the team in the game

ThirdDownPercentagenumber nullable

Percentage of third downs converted

FourthDownAttemptsinteger nullable

Total fourth down attempts by the team in the game

FourthDownConversionsinteger nullable

Total fourth down conversions by the team in the game

FourthDownPercentagenumber nullable

Percentage of fourth downs converted by the team in the game

RedZoneAttemptsinteger nullable

Total red zone opportunities by the team in the game

RedZoneConversionsinteger nullable

Total red zone opportunities converted into touchdowns by the team in the game

GoalToGoAttemptsinteger nullable

This field is deprecated

GoalToGoConversionsinteger nullable

This field is deprecated

ReturnYardsinteger nullable

Total punt and defensive return yards by the team in the game

Penaltiesinteger nullable

Total penalties committed by the team in the game

PenaltyYardsinteger nullable

Total penalty yards enforced against the team

Fumblesinteger nullable

Total fumbles by the team in the game

FumblesLostinteger nullable

Total fumbles lost by the team in the game

TimesSackedinteger nullable

Total number of sacks allowed by the team in the game

TimesSackedYardsinteger nullable

Total sack yards allowed by the team in the game

QuarterbackHitsinteger nullable

Total quarterback hits by the team in the game. Note: This is a defensive stat that includes sacks

TacklesForLossinteger 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)

Safetiesinteger nullable

Total defensive safeties scored by the team in the game

Puntsinteger nullable

Total number of punts by the team in the game

PuntYardsinteger nullable

Total punt yards by the team in the game

PuntAveragenumber

The average number of yards per punt by the team in the game

Giveawaysinteger

Total number of giveaways by the team in the game

Takeawaysinteger

Total takeaways by the team in the game

TurnoverDifferentialinteger

Total turnover differential (takeaways minus giveaways) by the team in the game

OpponentScoreQuarter1integer nullable

Points scored during Quarter 1 for the opponent team in the game

OpponentScoreQuarter2integer nullable

Points scored during Quarter 2 for the opponent team in the game

OpponentScoreQuarter3integer nullable

Points scored during Quarter 3 for the opponent team in the game

OpponentScoreQuarter4integer nullable

Points scored during Quarter 4 for the opponent team in the game

OpponentScoreOvertimeinteger

Points scored during overtime for the opponent team in the game

OpponentTimeOfPossessionMinutesinteger nullable

Total time of possession minutes for the opponent team in the game

OpponentTimeOfPossessionSecondsinteger nullable

Total time of possession seconds for the opponent team in the game

OpponentTimeOfPossessionstring nullable

Total time of possession for the opponent team in the game

OpponentFirstDownsinteger nullable

Total first downs converted by the opponent team in the game

OpponentFirstDownsByRushinginteger nullable

Total rushing first downs by the opponent team in the game

OpponentFirstDownsByPassinginteger nullable

Total passing first downs converted by the opponent team in the game

OpponentFirstDownsByPenaltyinteger nullable

Total first downs by penalty for the opponent team in the game

OpponentOffensivePlaysinteger

Total offensive plays by the opponent team in the game

OpponentOffensiveYardsinteger

Total offensive yards gained by the opponent team in the game

OpponentOffensiveYardsPerPlaynumber

Average yards gained per offensive play by the opponent team in the game

OpponentTouchdownsinteger nullable

Total touchdowns scored by the opponent team in the game

OpponentRushingAttemptsinteger nullable

Total rushing attempts by the opponent team in the game

OpponentRushingYardsinteger nullable

Total rushing yards by the opponent team in the game

OpponentRushingYardsPerAttemptnumber

Average rushing yards gained per attempt by the opponent team in the game

OpponentRushingTouchdownsinteger nullable

Total rushing touchdowns by the opponent team in the game

OpponentPassingAttemptsinteger nullable

Total passes thrown by the opponent team in the game

OpponentPassingCompletionsinteger nullable

Total passing completions by the opponent team in the game

OpponentPassingYardsinteger nullable

Total passing yards by the opponent team in the game

OpponentPassingTouchdownsinteger nullable

Total passing touchdowns by the opponent team in the game

OpponentPassingInterceptionsinteger nullable

Total interceptions thrown by the opponent team in the game

OpponentPassingYardsPerAttemptnumber

Average passing yards gained per attempt by the opponent team in the game

OpponentPassingYardsPerCompletionnumber

Average passing yards gained per completion by the opponent team in the game

OpponentCompletionPercentagenumber

Total completion percentage of the opponent team in the game

OpponentPasserRatingnumber nullable

Total passer rating by the opponent team in the game

OpponentThirdDownAttemptsinteger nullable

Total third down attempts by the opponent team in the game

OpponentThirdDownConversionsinteger nullable

Total third down conversions by the opponent team in the game

OpponentThirdDownPercentagenumber nullable

Total third down percentage by the opponent team in the game

OpponentFourthDownAttemptsinteger nullable

Total fourth downs attempted by the opponent team in the game

OpponentFourthDownConversionsinteger nullable

Total fourth downs converted by the opponent team in the game

OpponentFourthDownPercentagenumber nullable

Total fourth down conversion percentage by the opponent team in the game

OpponentRedZoneAttemptsinteger nullable

Total red zone opportunities by the opponent team in the game

OpponentRedZoneConversionsinteger nullable

Total red zone opportunities converted to touchdowns by the opponent team in the game

OpponentGoalToGoAttemptsinteger nullable

This field is deprecated

OpponentGoalToGoConversionsinteger nullable

This field is deprecated

OpponentReturnYardsinteger nullable

Total punt and defensive return yards by the opponent team in the game

OpponentPenaltiesinteger nullable

Total penalties enforced against the opponent team in the game

OpponentPenaltyYardsinteger nullable

Total penalty yards enforced against the opponent team in the game

OpponentFumblesinteger nullable

Total offensive fumbles by the opponent team in the game

OpponentFumblesLostinteger nullable

Total fumbles lost by the opponent team in the game

OpponentTimesSackedinteger nullable

Total sacks allowed by the opponent team in the game

OpponentTimesSackedYardsinteger nullable

Total yards as a result of a sack allowed by the opponent team in the game

OpponentQuarterbackHitsinteger nullable

Total quarterback hits by the opponent team in the game

OpponentTacklesForLossinteger nullable

Total tackles for loss by the opponent team in the game

OpponentSafetiesinteger nullable

Total safeties recorded by the opponent team in the game

OpponentPuntsinteger nullable

Total punts by the opponent team in the game

OpponentPuntYardsinteger nullable

Total punt yards by the opponent team in the game

OpponentPuntAveragenumber

Average number of yards per punt

OpponentGiveawaysinteger

Total giveaways by the opponent team in the game

OpponentTakeawaysinteger

Total takeaways by the opponent team in the game

OpponentTurnoverDifferentialinteger

Total turnover differential by the opponent team in the game (takeaways minus giveaways)

RedZonePercentagenumber nullable

Total percentage of red zone opportunities converted into touchdowns by the team in the game

GoalToGoPercentagenumber nullable

This field is deprecated

QuarterbackHitsDifferentialinteger nullable

The quarterback hits differential of the team in the game. Note: Determined by hits on opposing quarterback minus hits on own quarterback

TacklesForLossDifferentialinteger nullable

Total tackles for loss differential by the team in the game

QuarterbackSacksDifferentialinteger

Total sack differential of the team in the game

TacklesForLossPercentagenumber nullable

Total percentage of plays defended that resulted in a tackle for loss by the team in the game

QuarterbackHitsPercentagenumber nullable

Total percentage of opposing quarterback dropbacks that resulted in a quarterback hit by the team in the game

TimesSackedPercentagenumber

Total percentage of drop backs that resulted in a sack by the team in the game

OpponentRedZonePercentagenumber nullable

Percentage of opponent's red zone opportunities converted into touchdowns in the game

OpponentGoalToGoPercentagenumber nullable

This field is deprecated

OpponentQuarterbackHitsDifferentialinteger nullable

Total quarterback hits differential by the opponent team in the game

OpponentTacklesForLossDifferentialinteger nullable

Total tackles for loss differential by the opponent team in the game

OpponentQuarterbackSacksDifferentialinteger nullable

Total quarterback sacks differential by the opponent team in the game

OpponentTacklesForLossPercentagenumber nullable

Total percentage of tackles for loss by the opponent team in the game

OpponentQuarterbackHitsPercentagenumber nullable

Total quarterback hits percentage by the opponent team in the game

OpponentTimesSackedPercentagenumber

Total percentage of dropbacks that resulted in a sack allowed by the opponent team in the game

Kickoffsinteger nullable

Total number of kickoffs by the team in the game

KickoffsInEndZoneinteger nullable

Total kickoffs that went into the end zone by the team in the game

KickoffTouchbacksinteger nullable

Total kickoffs that resulted in touchbacks by the team in the game

PuntsHadBlockedinteger nullable

Total punts by the team that were blocked in the game

PuntNetAveragenumber nullable

The average net yards per punt by the team in the game

ExtraPointKickingAttemptsinteger nullable

Total extra point kick attempts by the team in the game

ExtraPointKickingConversionsinteger nullable

Total extra point kicks made by the team in the game

ExtraPointsHadBlockedinteger nullable

Total extra point kick attempts by the team that were blocked in the game

ExtraPointPassingAttemptsinteger nullable

Total two point conversions passing conversions by the team in the game

ExtraPointPassingConversionsinteger nullable

Total two point conversions passing conversions by the team in the game

ExtraPointRushingAttemptsinteger nullable

Total two point conversion rushing attempts by the team in the game

ExtraPointRushingConversionsinteger nullable

Total two point conversion rushing conversions in the game

FieldGoalAttemptsinteger nullable

Total field goal attempts by the team in the game

FieldGoalsMadeinteger nullable

Total field goals made by the team in game

FieldGoalsHadBlockedinteger nullable

Total field goals by the team that were blocked in the game

PuntReturnsinteger nullable

Total punt returns by the team in the game

PuntReturnYardsinteger nullable

Total punt return yards by the team in the game

KickReturnsinteger nullable

Total kickoff returns by the team in the game

KickReturnYardsinteger nullable

Total kickoff return yards by the team in the game

InterceptionReturnsinteger nullable

Total defensive interception returns by the team in the game

InterceptionReturnYardsinteger nullable

Total defensive interception return yards by the team in the game

OpponentKickoffsinteger nullable

Total kickoffs by the opponent team in the game

OpponentKickoffsInEndZoneinteger nullable

Total kickoffs that went into the end zone by the opponent team in the game

OpponentKickoffTouchbacksinteger nullable

Total kickoffs that resulted in touchbacks by the opponent team in the game

OpponentPuntsHadBlockedinteger nullable

Total punt yard that were blocked for the opponent team in the game

OpponentPuntNetAveragenumber nullable

This field is deprecated

OpponentExtraPointKickingAttemptsinteger nullable

Total extra point kick attempts by the opponent team in the game

OpponentExtraPointKickingConversionsinteger nullable

Total extra point kicks made by the opponent team in the game

OpponentExtraPointsHadBlockedinteger nullable

Total extra point kick attempts that were blocked against the opponent team in the game

OpponentExtraPointPassingAttemptsinteger nullable

Total two point conversion passing attempts by the opponent team in the game

OpponentExtraPointPassingConversionsinteger nullable

Total two point conversion passing conversions by the opponent team in the game

OpponentExtraPointRushingAttemptsinteger nullable

Total two point conversion rushing attempts by the opponent team in the game

OpponentExtraPointRushingConversionsinteger nullable

Total two point conversion rushing conversions by the opponent team in the game

OpponentFieldGoalAttemptsinteger nullable

Total field goal attempts by the opponent team in the game

OpponentFieldGoalsMadeinteger nullable

Total field goals made by the opponent team in the game

OpponentFieldGoalsHadBlockedinteger nullable

Total blocked field goals against the opponent team in the game

OpponentPuntReturnsinteger nullable

Total punt returns by the opponent team in the game

OpponentPuntReturnYardsinteger nullable

Total punt return yards by the opponent team in the game

OpponentKickReturnsinteger nullable

Total kickoff returns by the opponent team in the game

OpponentKickReturnYardsinteger nullable

Total kickoff return yards by the opponent team in the game

OpponentInterceptionReturnsinteger nullable

Total defensive interceptions by the opponent team in the game

OpponentInterceptionReturnYardsinteger nullable

Total defensive interception return yards by the opponent team in the game

SoloTacklesinteger nullable

Total defensive solo (unassisted) tackles by the team in the game

AssistedTacklesinteger nullable

Total defensive assisted tackles by the team in the game

Sacksinteger nullable

Total defensive sacks by the team in the game

SackYardsinteger nullable

Total defensive sack yards by the team in the game

PassesDefendedinteger nullable

Total passes defended by the team's defense in the game

FumblesForcedinteger nullable

Total fumbles forced on defense by the team in the game

FumblesRecoveredinteger nullable

Total defensive fumble recoveries by the team in the game

FumbleReturnYardsinteger nullable

Total fumble return yards by the team in the game

FumbleReturnTouchdownsinteger nullable

Total fumble return touchdowns by the team in the game

InterceptionReturnTouchdownsinteger nullable

Total defensive interception return touchdowns by the team in the game

BlockedKicksinteger nullable

Total blocked kicks by the team in the game. Note: BlockedKicks include Field Goals and Punts but NOT Extra Points

PuntReturnTouchdownsinteger nullable

Total punt return touchdowns by the team in the game

PuntReturnLonginteger nullable

The longest punt return by the team in the game

KickReturnTouchdownsinteger nullable

Total kickoff return touchdowns by the team in the game

KickReturnLonginteger nullable

Longest kick return by the team in the game

BlockedKickReturnYardsinteger nullable

Total blocked kick recovery return yards for the team in the game

BlockedKickReturnTouchdownsinteger nullable

Total blocked kick recovery return touchdowns for the team in the game

FieldGoalReturnYardsinteger nullable

Total field goal return yards by the team in the game. Note: This field excludes blocked field goals

FieldGoalReturnTouchdownsinteger nullable

Total field goal return touchdowns by the team in the game. Note: This field excludes blocked field goals

PuntNetYardsinteger nullable

The net yards of the punts by the team in the game

OpponentSoloTacklesinteger nullable

Total defensive solo tackles by the opponent team in the game

OpponentAssistedTacklesinteger nullable

Total defensive assisted tackles by the opponent team in the game

OpponentSacksinteger nullable

Total defensive sacks by the opponent team in the game

OpponentSackYardsinteger nullable

Total defensive sack yards by the opponent team in the game

OpponentPassesDefendedinteger nullable

Total passes defended by the opponent team in the game

OpponentFumblesForcedinteger nullable

Total defensive fumbles forced by the opponent team in the game

OpponentFumblesRecoveredinteger nullable

Total defensive fumble recoveries by the opponent team in the game

OpponentFumbleReturnYardsinteger nullable

Total defensive fumbles return yards by the opponent team in the game

OpponentFumbleReturnTouchdownsinteger nullable

Total defensive fumbles return touchdowns by the opponent team in the game

OpponentInterceptionReturnTouchdownsinteger nullable

Total defensive interception touchdowns by the opponent team in the game

OpponentBlockedKicksinteger nullable

Total blocked kicks against the opponent team in the game

OpponentPuntReturnTouchdownsinteger nullable

Total punt return touchdowns by the opponent team in the game

OpponentPuntReturnLonginteger nullable

Longest punt return by the opponent team in the game

OpponentKickReturnTouchdownsinteger nullable

Total kickoff return touchdowns by the opponent team in the game

OpponentKickReturnLonginteger nullable

Longest kick return by the opponent team in the game

OpponentBlockedKickReturnYardsinteger nullable

Total blocked kick return yards by the opponent team in the game

OpponentBlockedKickReturnTouchdownsinteger nullable

Total blocked kick return touchdowns by the opponent team in the game

OpponentFieldGoalReturnYardsinteger 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)

OpponentFieldGoalReturnTouchdownsinteger 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)

OpponentPuntNetYardsinteger nullable

This field is deprecated

IsGameOverboolean nullable

Whether the game is over (true/false)

TeamNamestring nullable

The full name of the team (e.g. New England Patriots; Los Angeles Chargers)

DayOfWeekstring nullable

The day of the week this game was played on (e.g. Sunday; Monday; Thursday)

PassingDropbacksinteger nullable

Total number of times the team dropped back to pass in the game

OpponentPassingDropbacksinteger nullable

Total passing dropbacks by the opponent team in the game

TeamGameIDinteger

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.

PointDifferentialinteger nullable

The team's total point differential in the game

PassingInterceptionPercentagenumber 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

PuntReturnAveragenumber nullable

The average punt return yardage for the team in the game

KickReturnAveragenumber nullable

Average kick return yards by the team in the game

ExtraPointPercentagenumber nullable

Team's percentage of extra points made in the game

FieldGoalPercentagenumber nullable

Team's percentage of field goals made in the game

OpponentPassingInterceptionPercentagenumber nullable

Percentage of passes that were intercepted against the opponent team in the game

OpponentPuntReturnAveragenumber nullable

Punt return average of the opponent team in the game

OpponentKickReturnAveragenumber nullable

Kick return average of the opponent team in the game

OpponentExtraPointPercentagenumber nullable

Total extra point percentage by the opponent team in the game

OpponentFieldGoalPercentagenumber nullable

Total field goal percentage by the opponent team in the game

PenaltyYardDifferentialinteger nullable

The team's penalty yard differential in the game

PuntReturnYardDifferentialinteger nullable

Punt return yard differential for the team in the game

KickReturnYardDifferentialinteger nullable

Total kick return yard differential by the team in the game

TwoPointConversionReturnsinteger nullable

Total successful two point conversion returns by the team in the game

OpponentTwoPointConversionReturnsinteger nullable

Total two point attempt returns converted by the defense for the opponent team in the game

TeamIDinteger nullable

The unique ID of this team

OpponentIDinteger nullable

Total defensive interceptions by the opponent team in the game

Daystring nullable

The date of the game (in US Eastern Time)

DateTimestring nullable

The date of the game (in US Eastern Time)

GlobalGameIDinteger nullable

A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues

GlobalTeamIDinteger nullable

A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues

GlobalOpponentIDinteger nullable

A globally unique ID for this team's opponent. This value is guaranteed to be unique across all sports/leagues

ScoreIDinteger

Unique ID of the score/game

Changes

No recorded changes to this operation across all 2 revisions of this API.