---
title: "Get team season state"
method: GET
path: "/api/teams/{id}/season-state"
tags: ["Teams"]
---

# Get team season state

`GET /api/teams/{id}/season-state`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/teams/{id}/season-state`
- Auth: none required

Public. The off-season hub gate for one team and nothing else: { teamId, teamSlug, seasonState: { state, hubEnabled } }. Same derivation as team.seasonState on GET /api/teams/{id}, for clients that only need the gate. `state` comes from the league's persisted hockey calendar window (LeagueSeasonWindow) and is compared in whole UTC days with endDate inclusive; a manual stateOverride or hubEnabled on that window wins over the dates. A team whose league has no window falls back to the default hockey calendar, but only for sport hockey — any other sport, and a team with no league, resolves to in_season with the hub closed. Archived and unknown refs 404; a blank ref is 400.

## Path parameters

- `id` string, required

## Response `200`

{ success, data: { teamId, teamSlug, seasonState } }

## Other responses

- `400`: VALIDATION_ERROR
- `404`: Team not found

## Changes

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

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/teams/:id/season-state/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)
