---
title: "Line Combinations - by Season"
method: GET
path: "/v3/nhl/stats/{format}/LinesBySeason/{season}"
tags: ["NHL v3 Stats"]
---

# Line Combinations - by Season

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

## Request

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

The line combinations - groups of skaters that play together - ordered and given by season.

## Path parameters

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

## Response `200`

Success

- TeamLine[]
  - `TeamID` integer: The unique ID of the team
  - `Key` string, nullable: "The abbreviation [Key] of the team associated with this market (Ex. BOS, EDM, LAK)"
  - `FullName` string, nullable: The team's full name (ex. Minnesota Wild; New York Islanders)
  - `EvenStrengthLines` PlayerLine[]: The even strength lines for this team
    - `LineNumber` integer: The line the player is on (e.g. 1, 2, 3, or 4)
    - `Position` string, nullable: The player's primary position. Possible values: C; RW; LW; D; or G
    - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their entire career
    - `Name` string, nullable: The full name of the player on the line
    - `Shoots` string, nullable: The hand the player shoots the puck with (right or left)
    - `LineType` string, nullable: The type of line the player is on (e.g. EvenStrength (EV); PowerPlay (PP); ShortHanded (SH))
  - `PowerPlayLines` PlayerLine[]: The power play lines for a given team
    - `LineNumber` integer: The line the player is on (e.g. 1, 2, 3, or 4)
    - `Position` string, nullable: The player's primary position. Possible values: C; RW; LW; D; or G
    - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their entire career
    - `Name` string, nullable: The full name of the player on the line
    - `Shoots` string, nullable: The hand the player shoots the puck with (right or left)
    - `LineType` string, nullable: The type of line the player is on (e.g. EvenStrength (EV); PowerPlay (PP); ShortHanded (SH))
  - `ShortHandedLines` PlayerLine[]: The short-handed/penalty-kill lines for this team
    - `LineNumber` integer: The line the player is on (e.g. 1, 2, 3, or 4)
    - `Position` string, nullable: The player's primary position. Possible values: C; RW; LW; D; or G
    - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their entire career
    - `Name` string, nullable: The full name of the player on the line
    - `Shoots` string, nullable: The hand the player shoots the puck with (right or left)
    - `LineType` string, nullable: The type of line the player is on (e.g. EvenStrength (EV); PowerPlay (PP); ShortHanded (SH))

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