---
title: "Position Distribution at Lap N"
method: GET
path: "/v1/analytics/position-at-lap"
tags: ["Analytics"]
---

# Position Distribution at Lap N

`GET /v1/analytics/position-at-lap`

## Request

- Base URL: `https://api.racehooks.io`
- URL: `https://api.racehooks.io/v1/analytics/position-at-lap`
- Auth: API key in header `Authorization`

Full 20-position probability distribution per driver at the requested lap number. Returns the CTMC steady-state distribution from the most recently persisted lap. Live on-demand projection to a future lap requires the in-memory Q matrix (available only during live ingest). The note field in the response documents this constraint. Requires the Custom plan.

## Query parameters

- `lap` integer
- `lapsAhead` integer

## Response `200`

Default Response

- object
  - `requestedLap` integer
  - `currentLap` integer
  - `raceId` string, nullable
  - `note` string
  - `drivers` object[]
    - `number` string
    - `driverId` string
    - `constructorId` string
    - `tla` string
    - `name` string
    - `team` string
    - `positionDistribution` number[]
    - `mostLikelyPosition` integer
    - `top3Probability` number

---

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