--- title: "Team Game Stats - by Week [Final]" method: GET path: "/v3/cfb/stats/{format}/TeamGameStatsByWeekFinal/{season}/{week}" tags: ["CFB v3 Stats"] --- # Team Game Stats - by Week \[Final\] `GET /v3/cfb/stats/{format}/TeamGameStatsByWeekFinal/{season}/{week}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/cfb/stats/{format}/TeamGameStatsByWeekFinal/{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 games 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[] - `StatID` integer: The unique ID of the stats associated with the team in this game - `TeamID` integer, nullable: The unique ID of the team - `SeasonType` integer, nullable: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar). - `Season` integer, nullable: The college football season of the game - `Name` string, nullable: The team's full name - `Team` string, nullable: The abbreviation [Key] of the team - `Score` integer, nullable: Total points scored by the team in the game - `OpponentScore` integer, nullable: Total points scored by the opponent team - `FirstDowns` integer, nullable: Total first downs converted by the team in the game - `ThirdDownConversions` integer, nullable: Total third down conversions by the team in the game - `ThirdDownAttempts` integer, nullable: Total third down attempts by the team in the game - `FourthDownConversions` integer, nullable: Total fourth down conversions by the team in the game - `FourthDownAttempts` integer, nullable: Total fourth down attempts by the team in the game - `Penalties` integer, nullable: Total penalties committed by the team in the game - `PenaltyYards` integer, nullable: Total penalties yards enforced against the team in the game - `TimeOfPossessionMinutes` integer, nullable: Total number of minutes the team possessed the ball for in the game - `TimeOfPossessionSeconds` integer, nullable: Total number of seconds the team possessed the ball for in the game - `GlobalTeamID` integer, nullable: A globally unique ID for the team. Note: This value is guaranteed to be unique across all sports/leagues. - `Week` integer, nullable: The NFL week of the game (weeks 18-21 denote playoff games) - `GameID` integer, nullable: The unique ID of this game - `OpponentID` integer, nullable: The unique ID of the team's opponent - `Opponent` string, nullable: The name of the opponent - `Day` string, nullable: The day of the game - `DateTime` string, nullable: The date and time of the game - `HomeOrAway` string, nullable: Whether the team is home or away - `IsGameOver` boolean: Whether the game is over (true/false) - `GlobalGameID` integer, nullable: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues. - `GlobalOpponentID` integer, nullable: A globally unique ID for this opponent. This value is guaranteed to be unique across all sports/leagues. - `Updated` string, nullable: The updated date and time of the stat. - `Created` string, nullable: The date and time of the created stat. - `Games` integer, nullable: Indicates whether or not a player has recorded any stats for a given game. - `FantasyPoints` number, nullable: Total fantasy points - `PassingAttempts` number, nullable: Total passing attempts - `PassingCompletions` number, nullable: Total passing completions - `PassingYards` number, nullable: Total passing yards - `PassingCompletionPercentage` number, nullable: Total passing completion percentage - `PassingYardsPerAttempt` number, nullable: Total passing yards per attempts - `PassingYardsPerCompletion` number, nullable: Total passing yards per completion - `PassingTouchdowns` number, nullable: Total passing touchdowns - `PassingInterceptions` number, nullable: Total passing interceptions - `PassingRating` number, nullable: Total passing rating - `RushingAttempts` number, nullable: Total rushing attempts - `RushingYards` number, nullable: Total rushing yards - `RushingYardsPerAttempt` number, nullable: Total rushing yards per attempt - `RushingTouchdowns` number, nullable: Total rushing touchdowns - `RushingLong` number, nullable: Longest rushing attempt - `Receptions` number, nullable: Total receptions - `ReceivingYards` number, nullable: Total receiving yards - `ReceivingYardsPerReception` number, nullable: Total receiving yards per reception - `ReceivingTouchdowns` number, nullable: Total receiving touchdowns - `ReceivingLong` number, nullable: Long receiving reception - `PuntReturns` number, nullable: Total punt returns - `PuntReturnYards` number, nullable: Total punt return yards - `PuntReturnYardsPerAttempt` number, nullable: Total punt return yards per attempt - `PuntReturnTouchdowns` number, nullable: Total punt return touchdowns - `PuntReturnLong` number, nullable: Longest punt return - `KickReturns` number, nullable: Total kick returns - `KickReturnYards` number, nullable: Total kick return yards - `KickReturnYardsPerAttempt` number, nullable: Total kick return yards per attempt - `KickReturnTouchdowns` number, nullable: Total kick return touchdowns - `KickReturnLong` number, nullable: Longest kick return - `Punts` number, nullable: Total punts - `PuntYards` number, nullable: Total punt yards - `PuntAverage` number, nullable: Total punt average - `PuntLong` number, nullable: Longest punt - `FieldGoalsAttempted` number, nullable: Total field goals attempted - `FieldGoalsMade` number, nullable: Total field goals made - `FieldGoalPercentage` number, nullable: Total field goal percentage - `FieldGoalsLongestMade` number, nullable: Longest field goal made - `ExtraPointsAttempted` number, nullable: Total extra points attempted - `ExtraPointsMade` number, nullable: Total extra points made - `Interceptions` number, nullable: Total interceptions - `InterceptionReturnYards` number, nullable: Total interception return yards - `InterceptionReturnTouchdowns` number, nullable: Total interception return touchdowns - `SoloTackles` number, nullable: Total Solo Tackles - `AssistedTackles` number, nullable: Total Assisted Tackles - `TacklesForLoss` number, nullable: Total Tackles for a loss of yardage - `Sacks` number, nullable: Total Quarterback Sacks - `PassesDefended` number, nullable: Total Passes Defended - `FumblesRecovered` number, nullable: Total Fumble Recoveries - `FumbleReturnTouchdowns` number, nullable: Total Fumbles Recovered and returned for a touchdown - `QuarterbackHurries` number, nullable: Total Quarterback Hurries. NOTE: This field is deprecated as of 2021. - `Fumbles` number, nullable: Total Fumbles - `FumblesLost` number, nullable: Total Fumbles Lost ## Other responses - `401`: Unauthorized --- [API](https://skmtc.dev/sportsdata/apis/cfb-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/cfb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/cfb-api/revisions/2937cc5c9322?raw)