---
title: "Driver Circuit Profile"
method: GET
path: "/v1/historical/drivers/{driverId}/circuits"
tags: ["Historical"]
---

# Driver Circuit Profile

`GET /v1/historical/drivers/{driverId}/circuits`

## Request

- Base URL: `https://api.racehooks.io`
- URL: `https://api.racehooks.io/v1/historical/drivers/{driverId}/circuits`
- Auth: none declared

Per-circuit performance profile for a driver: wins, podiums, poles, average positions. Includes aggregate categories (__street__, __road__). Pre-computed. Public, no authentication required.

## Path parameters

- `driverId` string, required

## Query parameters

- `series` string
- `limit` integer
- `offset` integer

## Response `200`

Successful response

- object: Successful response
  - `RHData` object
    - `series` string
    - `url` string
    - `limit` string: Requested page size, serialised as a string
    - `offset` string: Requested page offset, serialised as a string
    - `total` string: Total matching records, serialised as a string
    - `DriverCircuitTable` object
      - `driverId` string
      - `Driver` object
        - `driverId` string
        - `url` string
        - `givenName` string
        - `familyName` string
        - `permanentNumber` string
        - `code` string: 3-letter TLA, e.g. VER
        - `dateOfBirth` string: ISO 8601 date, e.g. 1997-09-30
        - `nationality` string
        - `activeFromYear` string
        - `activeToYear` string
        - `dateOfDeath` string: ISO 8601 date — omitted if still living
        - `placeOfBirth` string: Free-text birthplace — omitted if unknown
        - `countryOfBirth` string: Country slug — omitted if unknown
        - `secondNationality` string: Dual-nationality slug — omitted if none
        - `gender` string: male | female — omitted if unknown
      - `CircuitProfiles` object[]
        - `circuitId` string
        - `Circuit` object: Omitted for aggregate circuit categories
          - `circuitId` string
          - `url` string
          - `circuitName` string
          - `circuitFullName` string: Full official name — omitted if same as circuitName
          - `type` string: race | road | street — omitted if unknown
          - `direction` string: clockwise | anti_clockwise — omitted if unknown
          - `lengthKm` string: Circuit length in km — omitted if unknown
          - `turns` string: Number of corners — omitted if unknown
          - `totalRacesHeld` string: Total F1 races held at this circuit — omitted if unknown
          - `Location` object
            - `lat` string: Decimal degrees latitude
            - `long` string: Decimal degrees longitude
            - `locality` string
            - `country` string
        - `starts` string
        - `wins` string
        - `podiums` string
        - `poles` string
        - `avgFinishPosition` string: Omitted if unavailable
        - `avgGridPosition` string: Omitted if unavailable
        - `winRate` string: 0.0–1.0 — omitted if unavailable
        - `podiumRate` string: 0.0–1.0 — omitted if unavailable

---

[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)
