---
title: "Get All Events"
method: GET
path: "/v1/events"
tags: ["Events"]
---

# Get All Events

`GET /v1/events`

## Request

- Base URL: `https://api.racehooks.io`
- URL: `https://api.racehooks.io/v1/events`
- Auth: none declared

Returns F1 events with sessions nested on each event, public (no auth). Ordered by weekend start (first session), oldest first; pass order=desc for newest first. Filter with season=2026 (or upcoming=1). Paged: `limit` (default 24, max 500) and `offset`; the response carries `total`, `limit`, `offset` and `nextOffset` (the offset of the next page, null on the last page). Use events[].raceId (null until a race record exists) as the race id for /v1/fantasy and /v1/historical.

## Query parameters

- `limit` integer
- `offset` integer
- `upcoming` '1'
- `season` integer
- `year` string
- `order` 'asc' | 'desc'

## Response `200`

Season events with sessions

- object: Season events with sessions
  - `data` object
    - `events` object[]
      - `eventId` string
      - `name` string
      - `officialName` string
      - `countryCode` string
      - `countryName` string
      - `location` string
      - `circuitName` string
      - `circuitId` string, nullable
      - `circuitOutline` object, nullable
      - `raceId` string, nullable
      - `state` 'upcoming' | 'ongoing' | 'completed'
      - `type` string
      - `roundText` string
      - `date` string, nullable: Race date, YYYY-MM-DD, in the circuit's LOCAL calendar — identical to /v1/historical `date`. Session startDate values are UTC instants and can fall on the next day (Las Vegas).
      - `sessions` object[]
        - `sessionId` string
        - `type` string
        - `name` string
        - `status` string
        - `startDate` string
        - `endDate` string
        - `gmtOffset` string
        - `path` string
    - `total` integer
    - `limit` integer
    - `offset` integer
    - `nextOffset` integer, nullable: Offset of the next page, or null on the last.

---

[API](https://skmtc.dev/racehooks/apis/racehooks-api.md) · [All operations](https://skmtc.dev/racehooks/apis/racehooks-api/llms.txt) · [OpenAPI document](https://skmtc.dev/racehooks/apis/racehooks-api/revisions/2335b73f46e4?raw)