---
title: "Headshots"
method: GET
path: "/v3/nfl/headshots/{format}/Headshots"
tags: ["NFL v3 Headshots"]
---

# Headshots

`GET /v3/nfl/headshots/{format}/Headshots`

## Request

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

USA Today/IMAGN cropped action headshots for all active NFL players, delivered shortly after the season starts.

## Path parameters

- `format` 'JSON' | 'XML', required

## Response `200`

Success

- Headshot[]
  - `PlayerID` integer: The unique PlayerID of the player as assigned by SportsDataIO. Note: this ID will stay with the player throughout their entire career
  - `Name` string, nullable: The player's full name
  - `TeamID` integer, nullable: The unique ID of the team
  - `Team` string, nullable: The abbreviation [Key] of the team
  - `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
  - `PreferredHostedHeadshotUrl` string, nullable: The player's preferred hosted headshot URL. This returns the headshot with transparent background, if available.
  - `PreferredHostedHeadshotUpdated` string, nullable: The last updated date of the player's preferred hosted headshot.
  - `HostedHeadshotWithBackgroundUrl` string, nullable: The player's hosted headshot URL.
  - `HostedHeadshotWithBackgroundUpdated` string, nullable: The last updated date of the player's hosted headshot.
  - `HostedHeadshotNoBackgroundUrl` string, nullable: The player's transparent background hosted headshot URL.
  - `HostedHeadshotNoBackgroundUpdated` string, nullable: The last updated date of the player's transparent background hosted headshot.

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