---
title: "Fantasy Player Ownership Percentages (Season-Long) - by Week"
method: GET
path: "/v3/nfl/stats/{format}/PlayerOwnership/{season}/{week}"
tags: ["NFL v3 Stats"]
---

# Fantasy Player Ownership Percentages (Season-Long) - by Week

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

## Request

- Base URL: `https://api.sportsdata.io`
- URL: `https://api.sportsdata.io/v3/nfl/stats/{format}/PlayerOwnership/{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/PlayerOwnership/:season/:week/get.ts> (a function with typed inputs; its response is checked against the schema)

Projected fantasy ownership of all players for a given season.

## Path parameters

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

## Response `200`

Success

- PlayerOwnership[]
  - `PlayerID` integer: The unique PlayerID of the player as assigned by SportsDataIO. Note: this ID will stay with the player throughout their entire career
  - `Season` integer: The NFL season of the ownership info
  - `SeasonType` integer: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
  - `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
  - `Name` string, nullable: The player's full name
  - `Position` string, nullable: The player's fantasy football position. Possible values: QB; RB; WR; TE; DL; LB; DB; K; P; OL
  - `Team` string, nullable: The abbreviation [Key] of the team that the player is on
  - `TeamID` integer, nullable: The unique ID of the team that the player is on. Note: If the player is a free agent; this field is NULL
  - `OwnershipPercentage` number, nullable: Player's ownership percentage on NFL.com fantasy leagues during this week
  - `DeltaOwnershipPercentage` number, nullable: Player's change in ownership percentage on NFL.com fantasy leagues during this week
  - `StartPercentage` number, nullable: Player's starting lineup percentage on NFL.com fantasy leagues during this week
  - `DeltaStartPercentage` number, nullable: Player's change in starting lineup percentage on NFL.com fantasy leagues during this week

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