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 IDTierCadenceDescription
session.statusfreePer updateSession lifecycle: Started, Aborted, Finished, Finalised, Ends.
session.lap-countfreePer updateCurrent lap and total laps remaining.
driver.listfreePer updateDriver number, TLA, full name, team name, team colour.
session.clocklivePer updateSession countdown clock with remaining time and extrapolating flag.
session.infolivePer updateSession metadata: circuit, event, type, start/end dates, GMT offset.

Subscribe with the feedId via webhook or SSE. Tier shown is the minimum plan required.

session.statusSession Statusfree

Per update

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

Sample payload
json
{
  "feed": "session.status",
  "sessionId": "9560",
  "utc": "2026-06-08T14:32:18.441Z",
  "data": {
    "status": "started"
  }
}

session.lap-countLap Countfree

Per update

Current lap and total laps remaining.

Sample payload
json
{
  "feed": "session.lap-count",
  "sessionId": "9560",
  "utc": "2026-06-08T14:32:18.441Z",
  "data": {
    "currentLap": 42,
    "totalLaps": 78
  }
}

driver.listDriver Listfree

Per update

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

Sample payload
json
{
  "feed": "driver.list",
  "sessionId": "9560",
  "utc": "2026-06-08T14:32:18.441Z",
  "drivers": [
    {
      "driverId": "verstappen-max",
      "constructorId": "red-bull-racing",
      "number": "1",
      "tla": "VER",
      "name": "Max Verstappen",
      "team": "Red Bull Racing"
    },
    {
      "driverId": "norris-lando",
      "constructorId": "mclaren",
      "number": "4",
      "tla": "NOR",
      "name": "Lando Norris",
      "team": "McLaren F1 Team"
    },
    {
      "driverId": "leclerc-charles",
      "constructorId": "ferrari",
      "number": "16",
      "tla": "LEC",
      "name": "Charles Leclerc",
      "team": "Scuderia Ferrari"
    },
    {
      "driverId": "hamilton-lewis",
      "constructorId": "ferrari",
      "number": "44",
      "tla": "HAM",
      "name": "Lewis Hamilton",
      "team": "Scuderia Ferrari"
    },
    {
      "driverId": "russell-george",
      "constructorId": "mercedes",
      "number": "63",
      "tla": "RUS",
      "name": "George Russell",
      "team": "Mercedes-AMG Petronas F1 Team"
    }
  ]
}

session.clockExtrapolated Clocklive

Per update

Session countdown clock with remaining time and extrapolating flag.

Sample payload
json
{
  "feed": "session.clock",
  "sessionId": "9560",
  "utc": "2026-06-08T14:32:18.441Z",
  "data": {
    "clockUtc": "2026-06-08T14:32:18.000Z",
    "remaining": "0:38:14",
    "extrapolating": true
  }
}

session.infoSession Infolive

Per update

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

Sample payload
json
{
  "feed": "session.info",
  "sessionId": "9560",
  "utc": "2026-06-08T14:32:18.441Z",
  "data": {
    "sessionType": "Race",
    "sessionName": "Race",
    "startDate": "2026-06-08T13:00:00",
    "endDate": "2026-06-08T15:00:00",
    "gmtOffset": "02:00:00",
    "eventName": "Monaco Grand Prix",
    "officialName": "FORMULA 1 GRAND PRIX DE MONACO 2026",
    "location": "Monaco",
    "country": {
      "code": "MON",
      "name": "Monaco"
    },
    "circuit": {
      "id": "monaco",
      "name": "Monaco"
    }
  }
}
← Feed catalogTiming & Lap Data →