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

# List sports

`GET /v1/sports`

## Request

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

## Query parameters

- `active_only` boolean: Return only active sports (default true)

## Response `200`

Active sports with their leagues and current season summary

- SportsListResponse
  - `sports` Sport[]
    - `id` integer, nullable
    - `slug` string, nullable
    - `name` string, nullable
    - `is_team_sport` boolean, nullable
    - `leagues` LeagueSummary[]
      - `id` integer, nullable
      - `slug` string, nullable
      - `name` string, nullable
      - `abbreviation` string, nullable
      - `league_type` string, nullable
      - `country_code` string, nullable
      - `current_season` SeasonSummary
        - `id` integer, nullable
        - `year` integer, nullable
        - `name` string, nullable
        - `phase` string, nullable
        - `start_date` string, nullable
        - `end_date` string, 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)