---
title: "List league season windows"
method: GET
path: "/api/admin/leagues/{leagueId}/season-windows"
tags: ["Admin"]
---

# List league season windows

`GET /api/admin/leagues/{leagueId}/season-windows`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/admin/leagues/{leagueId}/season-windows`
- Auth: HTTP bearer

Platform admin only. Every persisted hockey calendar window for a league, newest season first: { windows: [{ id, leagueId, seasonYear, startDate, endDate, preseasonStartDate, stateOverride, hubEnabled, createdAt, updatedAt }] }. These rows drive seasonState on team detail (#999). Nullable stateOverride / hubEnabled mean the phase and hub switch are derived from the dates. 404 for an unknown league ref, so an empty list means no calendar is configured yet.

## Path parameters

- `leagueId` string, required

## Response `200`

{ success, data: { windows } }

## Other responses

- `401`: UNAUTHORIZED
- `403`: FORBIDDEN — platform admin only
- `404`: NOT_FOUND — unknown league

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/admin/leagues/:leagueId/season-windows/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
