---
title: "List seasons"
method: GET
path: "/v1/seasons"
tags: ["sports"]
---

# List seasons

`GET /v1/seasons`

## Request

- Base URL: `https://lumify.ai`
- URL: `https://lumify.ai/v1/seasons`
- Auth: HTTP bearer

## Query parameters

- `sport` string, nullable: Filter by sport slug (e.g. nhl, nba, soccer)
- `current_only` boolean: Return only currently active seasons (default true). Pass false to include historical/past seasons.

## Response `200`

Seasons per sport/league, optionally filtered

- SeasonsListResponse
  - `seasons` Season[]
    - `id` integer, nullable
    - `year` integer, nullable
    - `name` string, nullable
    - `phase` string, nullable
    - `start_date` string, nullable
    - `end_date` string, nullable
    - `is_current` boolean, nullable
    - `sport` object, nullable
    - `league` object, nullable
  - `total` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api.md) · [All operations](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api/revisions/f91ea41a2606?raw)