Standings

GET https://nhl.highlightly.net/standings NHL & NCAAH API

GET https://sports.highlightly.net/nhl/standings All Sports API

Retrieve standings for a specific league, conference or division.

Refresh interval: Up to an hour after a match for the associated league and season is finished
Pagination: limit and offset

There are several ways to fetch the data. Use abbreviation or leagueName to pick the conference, leagueType to filter by league type such as NHL, and year to choose the season.

Conferences

abbreviation is the short code and leagueName is the written out form. Either works.

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

Choosing a season

year narrows standings to a single season.

Standings rendered in a client application

Parameters

Parameter	Type	Description
`leagueType`optional	string	No description in the spec.e.g. `NHL`
`limit`optional	numberdefault `10`	No description in the spec.e.g. `5`
`offset`optional	numberdefault `0`	No description in the spec.e.g. `0`
`leagueName`optional	string	No description in the spec.e.g. `Western Conference`
`abbreviation`optional	string	No description in the spec.e.g. `WEST`
`year`optional	number	No description in the spec.e.g. `2025`

Request

cURLJavaScriptPython

curl --request GET \
  --url 'https://nhl.highlightly.net/standings?leagueType=NHL&leagueName=Western%20Conference' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

const params = new URLSearchParams({
  leagueType: 'NHL',
  leagueName: 'Western Conference'
})
const response = await fetch(`https://nhl.highlightly.net/standings?${params}`, {
  headers: {
    'x-rapidapi-key': process.env.HIGHLIGHTLY_API_KEY
  }
})

if (!response.ok) {
  throw new Error(`Highlightly responded ${response.status}`)
}

const data = await response.json()

import os
import requests

response = requests.get(
    'https://nhl.highlightly.net/standings',
    params={
        'leagueType': 'NHL',
        'leagueName': 'Western Conference',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

response.raise_for_status()
data = response.json()

Response

dataNhlStandingsDataResponse[]required17 fields

leagueNamestringrequired

abbreviationstringrequired

yearnumberrequired

leagueTypestringrequired

seasonTypestringrequired

startDatestringrequired

endDatestringrequired

dataNhlTeamStatsResponse[]required9 fields

teamNhlStandingsTeamResponserequired5 fields

idnumberrequired

logostringrequired

namestringrequired

displayNamestringrequired

abbreviationstringrequired

statisticsNhlStatsValueResponse[]required2 fields

valuestringrequired

displayNamestringrequired

paginationPaginationResponserequired3 fields

totalCountnumberrequiredAvailable number of items, relevant to the provided query.

offsetnumberrequired

limitnumberrequired

planPlanResponserequired2 fields

tierstringrequiredYour current API subscription tier.

messagestringrequiredExplanation message regarding your current tier.

Example response

              200 application/json
            

              {
  "data": [
    {
      "leagueName": "Eastern Conference",
      "abbreviation": "EAST",
      "year": 2024,
      "leagueType": "NHL",
      "seasonType": "Regular Season",
      "startDate": "2023-10-09T07:00:00.000Z",
      "endDate": "2024-04-19T06:59:00.000Z",
      "data": [
        {
          "team": {
            "id": 3,
            "logo": "https://highlightly.net/nhl/images/teams/1.png",
            "name": "Panthers",
            "displayName": "Florida Panthers",
            "abbreviation": "FLA"
          },
          "statistics": [
            {
              "value": "+4",
              "displayName": "Differential"
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "totalCount": 490,
    "offset": 20,
    "limit": 100
  },
  "plan": {
    "tier": "BASIC",
    "message": "Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"
  }
}
            

Values are the examples declared in the OpenAPI spec, not a captured live response.

Errors

Status	Description
`400`	Bad request descriptive error.
`500`	Internal server error.