Get league by ID

Retrieve one league by its id.

Use this to check whether a league you have stored still exists, or whether its information has been updated since you fetched it.

The seasons list comes back with it, so this is also the most direct way to refresh the seasons available for a league you already track, before requesting standings.

Parameters

Request

curl --request GET \
  --url 'https://handball.highlightly.net/leagues/{id}' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

const response = await fetch('https://handball.highlightly.net/leagues/{id}', {
  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://handball.highlightly.net/leagues/{id}',
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

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

Response

Example response

[
  {
    "id": 36526,
    "logo": "https://example.com/logos/league/36526.png",
    "name": "1. Bundesliga Women",
    "country": {
      "code": "DE",
      "name": "Germany",
      "logo": "https://example.com/logos/country/DE.png"
    },
    "seasons": [
      {
        "season": 2023
      }
    ]
  }
]

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

Errors

Using a league id

League ids come from leagues. These endpoints accept one.