{"tool":"spl-stats","description":"Read-only JSON API over the SPL stats warehouse.","endpoints":[{"path":"/","summary":"service info"},{"path":"/health","summary":"liveness + store counts"},{"path":"/describe","summary":"self-describing manifest"},{"path":"/summary","summary":"store counts + per-season match counts"},{"path":"/phases","summary":"phase -> competitions mapping"},{"path":"/glossary","summary":"plain-language definitions for the advanced ratings + chart-label quirks (?term= for one)"},{"path":"/career","summary":"person career (competitive phases by default; ?phase=all for everything)"},{"path":"/career/timeline","summary":"running total by game (the career arc); ?stat=points|goals|assists|saves|..."},{"path":"/gamelog","summary":"a person's per-game log"},{"path":"/sim/snapshot","summary":"recent per-player rates, career roles, pair history and an opponent pool for spl-cards' roster simulation (cached ~30 min)"},{"path":"/team","summary":"team record + player totals"},{"path":"/roster","summary":"a team's players, season or all-time"},{"path":"/standings","summary":"season standings"},{"path":"/playoffs","summary":"playoff field + bracket for a division, from its standings"},{"path":"/playoffs/formats","summary":"playoff formats and which competition uses which"},{"path":"/standings/rules","summary":"scoring + tiebreak rulesets standings use"},{"path":"/standings/timeline","summary":"position after each matchday (the numbers behind a bump chart)"},{"path":"/leaders","summary":"season leaderboard for one stat"},{"path":"/rating/leaders","summary":"season leaderboard sorted by mean advanced rating"},{"path":"/rating/top-games","summary":"the season's best single player-games by one rating (whole-game basis, same figure the leaderboards average); ?min_periods drops cameos"},{"path":"/rating/person/{person_id}","summary":"a player's advanced ratings averaged over a season"},{"path":"/wpa/match/{match_id}","summary":"Win Probability Added per player for one match, in percentage points (needs a verified period log)"},{"path":"/wpa/person/{person_id}","summary":"a player's season Win Probability Added (total and per period-log game)"},{"path":"/franchises","summary":"hand-maintained franchises (groups of teams under one identity) with team counts"},{"path":"/branding","summary":"every team's branding (acronym, home/away palettes, crest path); the feed spl-site reads"},{"path":"/team/{token}/branding","summary":"one team's branding; token is a team_id, club key, alias or name (409 + candidates if it fits several). PUT (secret-guarded) creates/updates it -- the spl-automation /set-club-data write path"},{"path":"/team/{token}/logo","summary":"a team's crest image (404 if none); also /logos/{club_key}.png"},{"path":"/matchup","summary":"which palette each side wears so the primaries don't clash, plus the Slapshot `clubs set` console command (?home=&away=, any team token)"},{"path":"/staff/roles","summary":"staff roles with their questions (secret-guarded). PUT /staff/roles/{role_key} creates/updates one"},{"path":"/staff/applications","summary":"staff applications (secret-guarded): POST submits one (a person + shared answers + a role entry per role); GET lists role entries (?role=&status=&limit=)"},{"path":"/staff/entries/{entry_id}","summary":"one role entry with its applicant context (secret-guarded); POST .../message attaches the Discord message, .../interview starts the interview thread, .../decision accepts or declines (a decline needs a reason; 409 + the winning state if already decided)"},{"path":"/resolve-team","summary":"what a typed team token means: the one team, or candidates (?q=)"},{"path":"/franchise-of/{team_id}","summary":"the franchise a team belongs to, or null"},{"path":"/franchise/{franchise_id}","summary":"one franchise and its teams; sub-routes /logo (image), /teams (season record), /seasons (combined record), /roster, /results, /stars, /milestones (franchise-games-only rungs)"},{"path":"/stars","summary":"weekly star candidates for one competition or team-name brand (offense/defense); ?explain=1 for match/row counts, team-mismatch exclusions, and near-misses outside the top 6"},{"path":"/match/{match_id}","summary":"one match with both box scores"},{"path":"/rating/match/{match_id}","summary":"one match's box score with advanced (Alto) ratings attached, period-by-period per player wherever a verified Slapshot period log exists (whole-game otherwise -- check each player's rating_basis); ?explain=1 for the per-stat breakdown"},{"path":"/rating/match/{match_id}.html","summary":"human-readable page: every Alto rating formula plus a worked per-player breakdown for one real match"},{"path":"/rating/match/{match_id}/periods","summary":"every Alto rating (performance, pucker+, offensive, defensive) rated once per period and averaged, instead of once over the whole match; needs a verified Slapshot period-log timeline plus enough league-wide verified period data to build a per-period baseline"},{"path":"/compare","summary":"compare players (repeat ?person=)"},{"path":"/h2h","summary":"head-to-head between two teams"},{"path":"/records","summary":"records (biggest win, streaks, single-game bests)"},{"path":"/milestones","summary":"milestone ledger (career threshold crossings)"},{"path":"/milestones/rungs","summary":"the milestone rung config (stat, threshold, tier)"},{"path":"/milestones/approaching","summary":"players closest to their next uncrossed rung"},{"path":"/profile/{person_id}","summary":"percentile profile (career or ?season=)"},{"path":"/archetype/{person_id}","summary":"a player's role + style-modifier label"},{"path":"/archetype/similar/{person_id}","summary":"players sharing a player's archetype role, closest radar shape first"},{"path":"/archetype/team/{team_id}","summary":"a team's play-style label (same vocabulary, ranked against every other team)"},{"path":"/series/career/{person_id}","summary":"cumulative stat by game (the career arc)"},{"path":"/series/form/{person_id}","summary":"per-game values + trailing average"},{"path":"/series/seasons/{person_id}","summary":"one value per season"},{"path":"/series/standings/{season_id}","summary":"rank per matchday (bump-chart data)"},{"path":"/series/h2h/{team_a}/{team_b}","summary":"cumulative goals across head-to-head meetings"},{"path":"/series/streak/{person_id}","summary":"point-streak runs over a career"},{"path":"/series/scatter","summary":"one point per player for a two-metric scatter"},{"path":"/series/rating-scatter","summary":"offensive vs. defensive rating, one point per player"},{"path":"/series/compare","summary":"several careers' cumulative stat by game (repeat ?person=)"},{"path":"/series/compare/form","summary":"several careers' rolling form (repeat ?person=)"},{"path":"/series/compare/profile","summary":"several percentile profiles (repeat ?person=)"},{"path":"/series/team/{team_id}","summary":"a team's roster overlaid as archetypes"},{"path":"/chart/profile/{person_id}.svg","summary":"the player profile radar as a shareable SVG"},{"path":"/chart/career/{person_id}.svg","summary":"career cumulative-stat arc as SVG"},{"path":"/chart/form/{person_id}.svg","summary":"rolling form as SVG"},{"path":"/chart/seasons/{person_id}.svg","summary":"per-season bars as SVG"},{"path":"/chart/standings/{season_id}.svg","summary":"standings bump chart as SVG"},{"path":"/chart/h2h/{team_a}/{team_b}.svg","summary":"head-to-head cumulative goals as SVG"},{"path":"/chart/streak/{person_id}.svg","summary":"point-streak strip as SVG"},{"path":"/chart/scatter.svg","summary":"two-metric scatter as SVG"},{"path":"/chart/rating-scatter.svg","summary":"offensive vs. defensive rating scatter as SVG"},{"path":"/chart/compare.svg","summary":"several careers' cumulative stat as SVG"},{"path":"/chart/compare/form.svg","summary":"several careers' rolling form as SVG"},{"path":"/chart/compare/profile.svg","summary":"several percentile profiles overlaid as SVG"},{"path":"/chart/team/{team_id}.svg","summary":"a team's roster archetypes as SVG"},{"path":"/season/{season_id}","summary":"season summary + top scorers"},{"path":"/find","summary":"name search (kind=player|team|competition); a merged account is reported as its canonical player"},{"path":"/person-aliases","summary":"curated person merges (one human, several LR accounts): alias -> canonical, with both accounts' names and games"},{"path":"/showcase","summary":"human-readable showcase page (HTML); ?team=<id> for a team card instead of a player's"},{"path":"/charts","summary":"gallery of every chart for one player/season (HTML)"},{"path":"POST /refresh","summary":"webhook: watch a fixture until its result is approved"},{"path":"POST /corrections/sync","summary":"webhook: pull staff result corrections from Directus, apply them over match/match_player, write each one's status back"},{"path":"POST /parse-logs","summary":"webhook: parse a match's period logs into a ParsedMatch + timeline"},{"path":"POST /streams","summary":"webhook: spl-automation claims or releases a caster for a fixture"},{"path":"POST /schedule","summary":"webhook: spl-automation schedules, reschedules or cancels a fixture (authoritative kickoff for the calendar feeds)"},{"path":"/calendar/team/{team_id}.ics","summary":"subscribable iCalendar feed of a team's fixtures (webcal://); ?season="},{"path":"/calendar/division.ics","summary":"iCalendar feed of a division's fixtures; ?competition=<division or raw label>&season="},{"path":"/calendar/match/{match_id}.ics","summary":"one fixture as an add-to-calendar file"},{"path":"/streams/live","summary":"claimed fixtures inside their 20-minute live window (derived from the clock, not a stored flag)"},{"path":"/live","summary":"games in progress, from partial period logs LR has not confirmed -- PROVISIONAL, never mixed into official views (design §8.7)"},{"path":"/live/{match_id}","summary":"one in-progress game: provisional score, cumulative player lines and per-period deltas; becomes superseded_by /recap once LR has the box score"},{"path":"/periods/{match_id}","summary":"structured per-period timeline for a parsed match (verified only)"},{"path":"/periods/fixture/{directus_id}/raw","summary":"the same, addressed by Directus fixture id (the staff download link)"},{"path":"/periods/{match_id}/raw","summary":"the verbatim period-log JSON files stored for a match (unoriented, not gated on verified)"},{"path":"/recap/{match_id}","summary":"one game, everything we know: official result + box score, phase, crosswalk, and the verified period timeline"},{"path":"/narration/{match_id}","summary":"the generated broadcast recap for one game (JSON; ?refresh=1 to regenerate)"},{"path":"/narration/{match_id}.txt","summary":"the recap as plain text"},{"path":"/narration/{match_id}.html","summary":"the recap as a page (HTML)"}]}