Leagues

A league is the competition layer. Every match is anchored to exactly one.

Identifier

The id field is stable across seasons — a single Premier League ID covers 2024/25, 2025/26 and beyond. Use it freely as a foreign key in your own database.

Fields

Field	Type	Notes
id	string	Stable identifier.
country	string	ISO country name (e.g. "Spain"). For continental tournaments it's the continent ("Europe", "South America").
name	string	Competition name (e.g. "LaLiga", "NBA").
season	string	The current season as we know it (e.g. "2025/26").
logo_url	string | null	Square competition logo. May be null for new or low-coverage competitions.

Listing tracked leagues

curl https://api.scorelytics.pro/v1/football/leagues \
  -H "X-API-Key: sk_live_..."

The list is ordered alphabetically by country then name.

Tracked vs. untracked

Your account ingests data only for tracked leagues. If you don't see a competition you'd expect, contact support — adding a league is a matter of flipping a flag on our side.

Standings

To get the current league table:

curl https://api.scorelytics.pro/v1/football/leagues/{leagueId}/standings \
  -H "X-API-Key: sk_live_..."

Standings are recomputed after every match concludes. For a historical snapshot tied to a specific match, use GET /v1/football/matches/{matchId}/standings instead.