---
title: "Get standings"
method: GET
path: "/nhl/standings"
tags: ["NHL, NCAAH.Standings"]
---

# Get standings

`GET /nhl/standings`

## Request

- Base URL: `https://sports.highlightly.net`
- URL: `https://sports.highlightly.net/nhl/standings`
- Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key`
- TypeScript: <https://skmtc.dev/highlightly/apis/sports-api-highlightly/docs/nhl/standings/get.ts> (a function with typed inputs; its response is checked against the schema)

> Refresh interval: Up to an hour after a match for the associated league and season is finished
  
  Retrieve standings data for a specific league, conference or division.
   
  There are numerous ways on how to fetch the data. You can utilise either `abbreviation` or `leagueName`:

  | League Name   | Abbreviation  |
  | -----------   | -----------   |
  | Metro Atlantic Athletic Conference | MAAC | 
  | Western Conference | WEST |
  | College Hockey America | CHA |
  | Eastern Conference | EAST |
  | East Coast Athletic Conference | ECAC |
  | Independent | IND |
  | Northeast 10 Conference |	NE10 |
  | Western Collegiate Hockey Association |	WCHA |
  | Central Collegiate Hockey Association |	CCHA |
  | Hockey East |	HE | 

Additionally you can specify the `year` parameter to narrow down the the standings for that season.

There are two other important parameters that are used to navigate through the pagination. The `limit` parameter defines what the number of returned standings will be. If the number of actual standings is above the `limit` value you can make subsequent requests by increasing the `offset` value. 

Below is an example on how you could render league associated standings
  
![Standings example](https://highlightly.net/assets/img/documentation/nhl/standings.png)

## Query parameters

- `leagueType` string
- `limit` number
- `offset` number
- `leagueName` string
- `abbreviation` string
- `year` number

## Headers

- `x-rapidapi-host` string, required
- `x-rapidapi-key` string, required

## Response `200`

- NhlStandingsDataResponseDto
  - `leagueName` string, required
  - `abbreviation` string, required
  - `year` number, required
  - `leagueType` string, required
  - `seasonType` string, required
  - `startDate` string, required
  - `endDate` string, required
  - `data` NhlTeamStatsResponseDto[], required
    - `team` NhlStandingsTeamResponseDto, required
      - `id` number, required
      - `logo` string, required
      - `name` string, required
      - `displayName` string, required
      - `abbreviation` string, required
    - `statistics` NhlStatsValueResponseDto[], required
      - `value` string, required
      - `displayName` string, required

## Other responses

- `400`: Bad request descriptive error.
- `500`: Internal server error.

---

[API](https://skmtc.dev/highlightly/apis/sports-api-highlightly.md) - [All operations](https://skmtc.dev/highlightly/apis/sports-api-highlightly/llms.txt) - [OpenAPI document](https://skmtc.dev/highlightly/apis/sports-api-highlightly/revisions/c8a366d3091f?raw)