--- title: "Player Game Stats - by Week [Final]" method: GET path: "/v3/cfb/stats/{format}/PlayerGameStatsByWeekFinal/{season}/{week}" tags: ["CFB v3 Stats"] --- # Player Game Stats - by Week \[Final\] `GET /v3/cfb/stats/{format}/PlayerGameStatsByWeekFinal/{season}/{week}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/cfb/stats/{format}/PlayerGameStatsByWeekFinal/{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 for all involved players across all teams' games on a given week after each game has concluded. ## Path parameters - `format` 'JSON' | 'XML', required - `season` string, required - `week` string, required ## Response `200` Success - PlayerGame[] - `StatID` integer: The unique ID of the stats associated with the player in this game - `TeamID` integer, nullable: The unique ID of the team associated with this player - `PlayerID` integer, nullable: The unique ID of the player as assigned by SportsDataIO. Note: this ID remains with the player their entire collegiate career - `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 player's full name - `Team` string, nullable: The abbreviation [Key] of the team that the player is on - `Position` string, nullable: The player's primary position. Possible values: C; CB; DB; DE; DL; DT; FB; G; K; KR; LB; LS; NT; OL; OLB; OT; P; PR; QB; RB; S; SS; TE; WR - `PositionCategory` string, nullable: The category (Offense, Defense or Special Teams) of the players position (OFF, DEF, ST) - `InjuryStatus` string, nullable: Indicates the player's injury status (possible values include: Probable, Questionable, Doubtful, Out) - `InjuryBodyPart` string, nullable: The body part that is injured (Knee, Groin, Calf, Hamstring, etc.) - `InjuryStartDate` string, nullable: The day that the injury started or was first discovered. - `InjuryNotes` string, nullable: Brief description of the player's injury and expected availability. - `GlobalTeamID` integer, nullable: A globally unique ID for this player's team. This value is guaranteed to be unique across all sports/leagues. - `DraftKingsPosition` string, nullable: The DraftKings player position for this game. - `DraftKingsSalary` integer, nullable: A DraftKings salary for the next "standard" slate this game is in. NOTE: this may change as slates start & this value changes to the next slate's salary. - `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)