Ids and names
How ids work, how records link, and dates.Every id carries its type: lg_ league, ss_ season, tm_ team, gm_ game, pl_ player, vn_ venue. They never change once given out.
Finding an id
Find the thing with a list call first, then use its id. A league from /v1/leagues?q=, its seasons from /v1/leagues/{league_id}/seasons, a team from /v1/teams?q=, a player from /v1/players?q=.
How records link
A game has its league, season, both teams and its venue, each with its id and name. Inside a game, every player is given with his id and name, so a goal, a penalty or a line leads straight to /v1/players/{player_id}.
Dates
A game's date is its local day. A few very old games are recorded with their season but not their day: their date is null. Seasons are labelled the way the league labels them, 2026-27 or 2026.
Names
Teams and leagues carry the names they had at the time, so a team that moved or renamed shows its old name in old seasons.