---
title: "Get a historical Formula 1 season"
method: GET
path: "/api/v2/history/seasons/{year}"
---

# Get a historical Formula 1 season

`GET /api/v2/history/seasons/{year}`

## Request

- Base URL: `https://api.racecalendar.app`
- URL: `https://api.racecalendar.app/api/v2/history/seasons/{year}`
- Auth: none declared

Returns the F1DB historical race schedule for one championship year, including circuit metadata. Year must be a published historical season, not an OpenF1 live year outside the history window.

## Path parameters

- `year` string, required: Four-digit championship year.

## Response `200`

Historical F1 season race schedule

- HistoricalSeasonPayload
  - `generatedAt` string, required
  - `races` HistoricalRaceSummary[], required
    - `circuit` HistoricalCircuit, required
      - `circuitId` string, required
      - `circuitName` string, required
      - `location` HistoricalCircuitLocation, required
        - `country` string, required
        - `latitude` number, nullable, required
        - `locality` string, required
        - `longitude` number, nullable, required
      - `url` string, nullable, required
    - `date` string, required
    - `raceName` string, required
    - `round` number, required
    - `time` string, nullable, required
    - `url` string, nullable, required
    - `year` number, required
  - `seasonUrl` string, nullable, required
  - `year` number, required

## Other responses

- `304`: Not modified
- `400`: Invalid request. Typed RFC 9457-compatible JSON (`ErrorResponse`) keeps `ok: false` plus `error` for iOS clients.
- `404`: Resource not found. Typed RFC 9457-compatible JSON (`ErrorResponse`) keeps `ok: false` plus `error` for iOS clients.
- `429`: Too many requests. Public calendar, season, standings, and track GET routes do not currently return 429; they only advertise an informational RateLimit ceiling. MCP cache-miss queries under `/api/v2/mcp/*` may return 429 with Retry-After. Identity and referral routes keep their existing D1 budgets.
- `500`: Internal server error. Typed RFC 9457-compatible JSON (`ErrorResponse`) keeps `ok: false` plus `error` for iOS clients.

---

[API](https://skmtc.dev/racecalendar/apis/race-calendar-formula-1-api.md) · [All operations](https://skmtc.dev/racecalendar/apis/race-calendar-formula-1-api/llms.txt) · [OpenAPI document](https://skmtc.dev/racecalendar/apis/race-calendar-formula-1-api/revisions/b2c2532b5f80?raw)