Feed Catalog›Session & Core

Session & Core

freelive

The ambient context every integration needs: where the session is in its lifecycle, the clock, the lap count, and the driver entry list. Use these to gate your timing logic and to label everything else. driver.list maps the driver numbers that key most other feeds.

Feed IDAccess classCadenceDescription
session.statusfree
All plans
Per updateSession lifecycle: Started, Aborted, Finished, Finalised, Ends.
session.lap-countfree
All plans
Per updateCurrent lap and total laps remaining.
driver.listfree
All plans
Per updateDriver number, TLA, full name, team name, team colour.
session.clocklive
Developer plan
Per updateSession countdown clock with remaining time and extrapolating flag.
session.infolive
Developer plan
Per updateSession metadata: circuit, event, type, start/end dates, GMT offset.

Subscribe with the feedId via webhook or SSE. The badge shows the feed's access class: free feeds are open to every plan, live feeds require the Developer plan, and analytics feeds require the Custom plan.

session.statusSession Statusfree

Per update

Session lifecycle: Started, Aborted, Finished, Finalised, Ends.

Payload fields
FieldTypeDescription
data.statusstringSample: "started"

Every delivery carries feed, sessionId and utc.

Sample payload: recorded Canadian Grand Prix (2026-canada_r)
json
{
  "feed": "session.status",
  "sessionId": "2026-canada_r",
  "utc": "2026-10-05T18:11:28.392Z",
  "data": {
    "status": "started"
  }
}

Subscribe: webhooks · quickstart · SDK · GET /v1/feeds

session.lap-countLap Countfree

Per update

Current lap and total laps remaining.

Payload fields
FieldTypeDescription
data.currentLapnumberSample: 0
data.totalLapsnumberSample: 68

Every delivery carries feed, sessionId and utc.

Sample payload: recorded Canadian Grand Prix (2026-canada_r)
json
{
  "feed": "session.lap-count",
  "sessionId": "2026-canada_r",
  "utc": "2026-10-05T18:09:44.695Z",
  "data": {
    "currentLap": 0,
    "totalLaps": 68
  }
}

Subscribe: webhooks · quickstart · SDK · GET /v1/feeds

driver.listDriver Listfree

Per update

Driver number, TLA, full name, team name, team colour.

Sample payload: recorded Canadian Grand Prix (2026-canada_r)

recorded frame; driver identity fields completed from the driver registry, timing.data trimmed to 3 rows

json
{
  "feed": "driver.list",
  "sessionId": "2026-canada_r",
  "utc": "2026-10-05T18:49:56.756Z",
  "drivers": [
    {
      "driverId": "antonelli-kimi",
      "constructorId": "mercedes",
      "number": "12",
      "tla": "ANT",
      "name": "Kimi Antonelli",
      "team": "Mercedes"
    },
    {
      "driverId": "russell-george",
      "constructorId": "mercedes",
      "number": "63",
      "tla": "RUS",
      "name": "George Russell",
      "team": "Mercedes"
    }
  ]
}

Subscribe: webhooks · quickstart · SDK · GET /v1/feeds

session.clockExtrapolated Clocklive

Per update

Session countdown clock with remaining time and extrapolating flag.

Payload fields
FieldTypeDescription
data.clockUtcstringSample: "2026-05-24T20:09:48.004Z"
data.remainingstringSample: "01:59:59"
data.extrapolatingbooleanSample: true

Every delivery carries feed, sessionId and utc.

Sample payload: recorded Canadian Grand Prix (2026-canada_r)
json
{
  "feed": "session.clock",
  "sessionId": "2026-canada_r",
  "utc": "2026-10-05T18:11:28.642Z",
  "data": {
    "clockUtc": "2026-05-24T20:09:48.004Z",
    "remaining": "01:59:59",
    "extrapolating": true
  }
}

Subscribe: webhooks · quickstart · SDK · GET /v1/feeds

session.infoSession Infolive

Per update

Session metadata: circuit, event, type, start/end dates, GMT offset.

Payload fields
FieldTypeDescription
data.sessionTypestringSample: "Race"
data.sessionNamestringSample: "Race"
data.startDatestringSample: "2026-05-24T16:00:00"
data.endDatestringSample: "2026-05-24T18:00:00"
data.gmtOffsetstringSample: "-04:00:00"
data.eventNamestringSample: "Canadian Grand Prix"
data.officialNamestringSample: "FORMULA 1 LENOVO GRAND PRIX DU CANADA 2026"
data.locationstringSample: "Montréal"
data.country.codestringSample: "CAN"
data.country.namestringSample: "Canada"
data.circuit.idstringSample: "montreal"
data.circuit.namestringSample: "Montreal"

Every delivery carries feed, sessionId and utc.

Sample payload: recorded Canadian Grand Prix (2026-canada_r)
json
{
  "feed": "session.info",
  "sessionId": "2026-canada_r",
  "utc": "2026-10-05T18:11:28.392Z",
  "data": {
    "sessionType": "Race",
    "sessionName": "Race",
    "startDate": "2026-05-24T16:00:00",
    "endDate": "2026-05-24T18:00:00",
    "gmtOffset": "-04:00:00",
    "eventName": "Canadian Grand Prix",
    "officialName": "FORMULA 1 LENOVO GRAND PRIX DU CANADA 2026",
    "location": "Montréal",
    "country": {
      "code": "CAN",
      "name": "Canada"
    },
    "circuit": {
      "id": "montreal",
      "name": "Montreal"
    }
  }
}

Subscribe: webhooks · quickstart · SDK · GET /v1/feeds

← Feed catalogTiming & Lap Data →