---
title: "Team Stats Allowed - by Position"
method: GET
path: "/v3/nhl/stats/{format}/TeamStatsAllowedByPosition/{season}"
tags: ["NHL v3 Stats"]
---

# Team Stats Allowed - by Position

`GET /v3/nhl/stats/{format}/TeamStatsAllowedByPosition/{season}`

## Request

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

Aggregated season stats allowed by each team against a given position (e.g. C, LW.)

## Path parameters

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

## Response `200`

Success

- TeamSeason[]
  - `StatID` integer: The unique ID of the stat
  - `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; 5=AllStar; 6=Exhibition)
  - `Season` integer, nullable: The NHL regular season for which these totals apply
  - `Name` string, nullable: The team's full name (ex. Minnesota Wild; New York Islanders)
  - `Team` string, nullable: The abbreviation [Key] of the team
  - `Wins` integer, nullable: Total number of wins by the team in the season
  - `Losses` integer, nullable: Total losses for the team in the season
  - `OvertimeLosses` integer, nullable: Total overtime losses by the team in the season
  - `OpponentPosition` string, nullable: Indicates which position is included in opponent stats that are aggregated together
  - `GlobalTeamID` integer, nullable: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues
  - `OpponentStat` OpponentSeason
    - `StatID` integer: The unique ID of the stat
    - `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; 5=AllStar; 6=Exhibition)
    - `Season` integer, nullable: The NHL regular season for which these totals apply
    - `Name` string, nullable: The team's full name (ex. Minnesota Wild; New York Islanders)
    - `Team` string, nullable: The abbreviation [Key] of the team
    - `Wins` integer, nullable: Total number of wins by the team in the season
    - `Losses` integer, nullable: Total losses for the team in the season
    - `OvertimeLosses` integer, nullable: Total overtime losses by the team in the season
    - `OpponentPosition` string, nullable: Indicates which position is included in opponent stats that are aggregated together
    - `GlobalTeamID` integer, nullable: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues
    - `Updated` string, nullable: The timestamp of when the record was last updated (US Eastern Time).
    - `Games` integer, nullable: The number of games played.
    - `FantasyPoints` number, nullable: Total fantasy points
    - `FantasyPointsFanDuel` number, nullable: Total FanDuel daily fantasy points scored
    - `FantasyPointsDraftKings` number, nullable: Total DraftKings daily fantasy points scored
    - `FantasyPointsYahoo` number, nullable: Total Yahoo daily fantasy points scored
    - `Minutes` integer, nullable: Total number of minutes played
    - `Seconds` integer, nullable: Total number of seconds played
    - `Goals` number, nullable: Total number of goals scored
    - `Assists` number, nullable: Total number of assists
    - `ShotsOnGoal` number, nullable: Total number of shots on goal
    - `PowerPlayGoals` number, nullable: Total number of power play goals
    - `ShortHandedGoals` number, nullable: Total number of short handed goals
    - `EmptyNetGoals` number, nullable: Total number of empty net goals
    - `PowerPlayAssists` number, nullable: Total number of power play assists
    - `ShortHandedAssists` number, nullable: Total number of short handed assists
    - `HatTricks` number, nullable: Total number of hat tricks
    - `ShootoutGoals` number, nullable: Total number of shootout goals
    - `PlusMinus` number, nullable: Total plus minus
    - `PenaltyMinutes` number, nullable: Total pentalty minutes
    - `Blocks` number, nullable: Total blocked shots
    - `Hits` number, nullable: Total hits
    - `Takeaways` number, nullable: Total takeaways
    - `Giveaways` number, nullable: Total giveaways
    - `FaceoffsWon` number, nullable: Total faceoffs won
    - `FaceoffsLost` number, nullable: Total faceoffs lost
    - `Shifts` number, nullable: Total shifts
    - `GoaltendingMinutes` integer, nullable: Total goaltending minutes
    - `GoaltendingSeconds` integer, nullable: Total goaltending seconds
    - `GoaltendingShotsAgainst` number, nullable: Total goaltending shots against
    - `GoaltendingGoalsAgainst` number, nullable: Total goaltending goals against
    - `GoaltendingSaves` number, nullable: Total goaltending saves
    - `GoaltendingWins` number, nullable: Total goaltending wins
    - `GoaltendingLosses` number, nullable: Total goaltendings losses
    - `GoaltendingShutouts` number, nullable: Total goaltendings shutouts
    - `Started` integer, nullable: Total games started
    - `BenchPenaltyMinutes` number, nullable: Total bench pentalty minutes
    - `GoaltendingOvertimeLosses` number, nullable: Total goaltending overtime losses
    - `FantasyPointsFantasyDraft` number, nullable: Total FantasyDraft daily fantasy points scored
  - `Updated` string, nullable: The timestamp of when the record was last updated (US Eastern Time).
  - `Games` integer, nullable: The number of games played.
  - `FantasyPoints` number, nullable: Total fantasy points
  - `FantasyPointsFanDuel` number, nullable: Total FanDuel daily fantasy points scored
  - `FantasyPointsDraftKings` number, nullable: Total DraftKings daily fantasy points scored
  - `FantasyPointsYahoo` number, nullable: Total Yahoo daily fantasy points scored
  - `Minutes` integer, nullable: Total number of minutes played
  - `Seconds` integer, nullable: Total number of seconds played
  - `Goals` number, nullable: Total number of goals scored
  - `Assists` number, nullable: Total number of assists
  - `ShotsOnGoal` number, nullable: Total number of shots on goal
  - `PowerPlayGoals` number, nullable: Total number of power play goals
  - `ShortHandedGoals` number, nullable: Total number of short handed goals
  - `EmptyNetGoals` number, nullable: Total number of empty net goals
  - `PowerPlayAssists` number, nullable: Total number of power play assists
  - `ShortHandedAssists` number, nullable: Total number of short handed assists
  - `HatTricks` number, nullable: Total number of hat tricks
  - `ShootoutGoals` number, nullable: Total number of shootout goals
  - `PlusMinus` number, nullable: Total plus minus
  - `PenaltyMinutes` number, nullable: Total pentalty minutes
  - `Blocks` number, nullable: Total blocked shots
  - `Hits` number, nullable: Total hits
  - `Takeaways` number, nullable: Total takeaways
  - `Giveaways` number, nullable: Total giveaways
  - `FaceoffsWon` number, nullable: Total faceoffs won
  - `FaceoffsLost` number, nullable: Total faceoffs lost
  - `Shifts` number, nullable: Total shifts
  - `GoaltendingMinutes` integer, nullable: Total goaltending minutes
  - `GoaltendingSeconds` integer, nullable: Total goaltending seconds
  - `GoaltendingShotsAgainst` number, nullable: Total goaltending shots against
  - `GoaltendingGoalsAgainst` number, nullable: Total goaltending goals against
  - `GoaltendingSaves` number, nullable: Total goaltending saves
  - `GoaltendingWins` number, nullable: Total goaltending wins
  - `GoaltendingLosses` number, nullable: Total goaltendings losses
  - `GoaltendingShutouts` number, nullable: Total goaltendings shutouts
  - `Started` integer, nullable: Total games started
  - `BenchPenaltyMinutes` number, nullable: Total bench pentalty minutes
  - `GoaltendingOvertimeLosses` number, nullable: Total goaltending overtime losses
  - `FantasyPointsFantasyDraft` number, nullable: Total FantasyDraft daily fantasy points scored

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/sportsdata/apis/nhl-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/nhl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/nhl-api/revisions/23cc22d7f2ad?raw)
