Get league by ID

Retrieve one league by its id.

Use this to check whether a competition 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 cheapest way to refresh the seasons available for a competition you already track, before requesting standings.

Parameters

Request

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

const response = await fetch('https://rugby.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://rugby.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": 48440,
    "logo": "https://example.com/logos/league/48440.png",
    "name": "Six Nations U20",
    "country": {
      "code": "EU",
      "name": "Europe",
      "logo": "https://example.com/logos/country/EU.png"
    },
    "seasons": [
      {
        "season": 2024
      }
    ]
  }
]

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.