---
title: "Get Seasons"
method: GET
path: "/seasons"
tags: ["Seasons"]
---

# Get Seasons

`GET /seasons`

## Request

- Base URL: `https://racinghub.net/api/v1`
- URL: `https://racinghub.net/api/v1/seasons`
- Auth: none declared
- TypeScript: <https://skmtc.dev/racinghub/apis/racinghub-api-formula-1-historical-data-statistics/docs/seasons/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a paginated list of all Formula 1 seasons. Includes season year, number of races, and champion information. Supports pagination with page and limit parameters.

## Query parameters

- `page` integer: Page number
- `limit` integer: Number of items per page

## Response `200`

Successful Response

- PagedResponseSeasonResponse
  - `data` SeasonResponse[], required
    - `year` integer, required
    - `total_races` integer, required
    - `total_drivers` integer, required
    - `total_constructors` integer, required
    - `champion` DriverChampionResponse, required
      - `driver_id` string, required
      - `driver_name` string, required
      - `points` number, required
      - `race_wins` integer, required
      - `pole_positions` integer, required
    - `constructor_champion` ConstructorChampionResponse, required
      - `constructor_id` string, required
      - `constructor_name` string, required
      - `points` number, required
      - `race_wins` integer, required
      - `pole_positions` integer, required
  - `page` integer, required
  - `limit` integer, required
  - `total` integer, required
  - `total_pages` integer, required
  - `has_next` boolean, required: Whether there's a next page
  - `has_previous` boolean, required: Whether there's a previous page

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/racinghub/apis/racinghub-api-formula-1-historical-data-statistics.md) - [All operations](https://skmtc.dev/racinghub/apis/racinghub-api-formula-1-historical-data-statistics/llms.txt) - [OpenAPI document](https://skmtc.dev/racinghub/apis/racinghub-api-formula-1-historical-data-statistics/revisions/c555fc623fe2?raw)