---
title: "Get Races"
method: GET
path: "/races"
tags: ["Races"]
---

# Get Races

`GET /races`

Retrieve a paginated list of all Formula 1 races, including race name, date, season, circuit, and round. Supports pagination with page and limit parameters.

## Query parameters

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

## Response `200`

Successful Response

- PagedResponseRaceResponse
  - `data` RaceResponse[], required
    - `id` integer, required
    - `year` integer, required
    - `round` integer, required
    - `date` string, date, required
    - `official_name` string, required
    - `grand_prix_id` string, required
    - `circuit_id` string, required
    - `circuit_type` string, nullable
    - `direction` string, nullable
    - `course_length` string, nullable
    - `turns` integer, nullable
    - `laps` integer, nullable
    - `distance` string, nullable
    - `scheduled_laps` integer, nullable
    - `scheduled_distance` string, nullable
    - `time` string, nullable
    - `qualifying_format` string, nullable
    - `sprint_qualifying_format` string, nullable
    - `drivers_championship_decider` boolean
    - `constructors_championship_decider` boolean
    - `pre_qualifying` SessionResponse
      - `date` string, date, nullable
      - `time` string, nullable
    - `free_practice_1` SessionResponse
      - `date` string, date, nullable
      - `time` string, nullable
    - `free_practice_2` SessionResponse
      - `date` string, date, nullable
      - `time` string, nullable
    - `free_practice_3` SessionResponse
      - `date` string, date, nullable
      - `time` string, nullable
    - `free_practice_4` SessionResponse
      - `date` string, date, nullable
      - `time` string, nullable
    - `qualifying_1` SessionResponse
      - `date` string, date, nullable
      - `time` string, nullable
    - `qualifying_2` SessionResponse
      - `date` string, date, nullable
      - `time` string, nullable
    - `qualifying` SessionResponse
      - `date` string, date, nullable
      - `time` string, nullable
    - `sprint_qualifying` SessionResponse
      - `date` string, date, nullable
      - `time` string, nullable
    - `sprint_race` SessionResponse
      - `date` string, date, nullable
      - `time` string, nullable
    - `warming_up` SessionResponse
      - `date` string, date, nullable
      - `time` string, nullable
  - `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.net/racinghub/apis/racinghub-api-formula-1-historical-data-statistics.md) · [All operations](https://skmtc.net/racinghub/apis/racinghub-api-formula-1-historical-data-statistics/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/racinghub/racinghub-api-formula-1-historical-data-statistics/revisions/c555fc623fe2/schema)