ReferenceData modelCompetitions & editions
Competitions & editions
Competitions, editions/seasons, capability discovery, event summaries, and temporal anchors.
Competitions replace the old league lens. An edition is one running of a competition, and capability discovery describes the per-phase measures available for that competition.
CompetitionobjectA competition — roughly today's `league_id` made first-class (`laliga`,CompetitionCapabilitiesobjectThe capability surface for a competition: its resolved sport plus theCompetitionIdscalarMinted entity id (`comp_<base32>`).CompetitionKindenumThe shape of a competition. Replaces the old international-league boolean —CompetitionListResponseobjectCompetitionSlugscalarStable human address for a competition (e.g. `mlb`, `nba`, `laliga`, `caribbean_series`). Lowercase ASCII; multi-word slugs use single underscores, but most registered slugs are single concatenated words — `laliga`, `seriea`, `ligue1`, `ncaab`, `ncaaf`. Discover the canonical set via `GET /v1/competitions`.CompetitionStandingsobjectThe DEFAULT standings read (no explicit year): the served edition's yearDateRangeobjectAn inclusive `[start, end]` interval over UTC instants. The temporal anchorEditionobjectAn `Edition` — one running (season) of a competition, with the dated anchor.EditionIdscalarMinted entity id (`edt_<base32>`).EditionListResponseobjectEventIdscalarMinted entity id (`evt_<base32>`).EventKindenumThe kind of intra-edition grouping an [`Event`](crate::ids::EventId)EventLineageSlugscalarStable cross-edition identity of a recurring event: lowercase ASCII words joined by single underscores (e.g. `wimbledon`).EventSummaryobjectThe read-side summary of an intra-edition grouping attached to a contest:PhaseCapabilitiesobjectOne phase's measure inventory inside a competition's capability surface — theRoundunionA bracket round label (spec §4.6). Minimal: numbered early rounds, the namedSeasonYearscalar