---
title: "Fantasy Points - by Week"
method: GET
path: "/v3/nfl/stats/{format}/FantasyGameStatsByWeek/{season}/{week}"
tags: ["NFL v3 Stats"]
---

# Fantasy Points - by Week

`GET /v3/nfl/stats/{format}/FantasyGameStatsByWeek/{season}/{week}`

## Request

- Base URL: `https://api.sportsdata.io`
- URL: `https://api.sportsdata.io/v3/nfl/stats/{format}/FantasyGameStatsByWeek/{season}/{week}`
- Auth: one of:
  - API key in header `Ocp-Apim-Subscription-Key`
  - API key in query parameter `key`
- TypeScript: <https://skmtc.dev/sportsdata/apis/nfl-api/docs/v3/nfl/stats/:format/FantasyGameStatsByWeek/:season/:week/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a simple list of fantasy points and stats for each player for a given week.

## Path parameters

- `format` 'JSON' | 'XML', required
- `season` string, required
- `week` string, required

## Response `200`

Success

- FantasyGame[]
  - `GameID` integer, nullable: The unique ID of this game
  - `PlayerID` integer, nullable: The unique PlayerID of the player as assigned by SportsDataIO tied to this FantasyGame record Note: this ID will stay with the player throughout their entire career
  - `SeasonType` integer: The type of season that this player corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=All-Star).
  - `Season` integer: The NFL season of the game
  - `Day` string, nullable: The date of the game (in US Eastern Time)
  - `DateTime` string, nullable: The date and time of the game (in US Eastern Time)
  - `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
  - `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
  - `Number` integer: Player's jersey number
  - `Name` string, nullable: Player's full name
  - `Position` string, nullable: The primary position of the player Possible Values: C; CB; DB; DE; DL; DT; FB; FS; G; ILB; K; KR; LB; LS; NT; OL; OLB; OT; P; QB; RB; S; SS; T; TE; WR
  - `PositionCategory` string, nullable: The category of the player's position (OFF; DEF; ST)
  - `Activated` integer: Whether or not the player was active for the game
  - `Played` integer: Whether the player played at least one snap in the game Note: Will return "1" if player played at least one snap and "0" if they did not
  - `Started` integer: Whether the player started the game (on offensive or defense) Note: Started = 1 / Did Not Start = 0
  - `FantasyPoints` number: Total fantasy points by the player in the game
  - `FantasyPointsPPR` number: Fantasy points scored based on basic PPR fantasy scoring system by the player in the game
  - `FantasyPosition` string, nullable: The player's fantasy football position Possible values: QB; RB; WR; TE; DL; LB; DB; K; P; OL
  - `IsGameOver` boolean, nullable: Whether the game is over (true/false)
  - `FantasyPointsFanDuel` number, nullable: Fantasy points based on FanDuel's scoring system by the player in the game
  - `FantasyPointsYahoo` number, nullable: Fantasy points based on Yahoo's daily fantasy scoring system by the player in the game
  - `FantasyPointsDraftKings` number, nullable: Total DraftKings daily fantasy points scored by the player in the game
  - `FanDuelPosition` string, nullable: The player's eligible position in FanDuel's daily fantasy sports platform
  - `DraftKingsPosition` string, nullable: The player's eligible position in DraftKings' daily fantasy sports platform
  - `YahooPosition` string, nullable: The player's eligible position in Yahoo's daily fantasy sports platform
  - `OpponentRank` integer, nullable: The ranking of the player's opponent with regards to fantasy points allowed
  - `OpponentPositionRank` integer, nullable: The ranking of the player's opponent by position with regards to fantasy points allowed
  - `GlobalGameID` integer, nullable: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues
  - `Updated` string, nullable: Time of last update (in US Eastern time) Note: this does not indicate that stats changed

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