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 —driverlist maps the driver numbers that key most other feeds.

Feed IDTierCadenceDescription
sessionstatusfreePer updateSession lifecycle: Started, Aborted, Finished, Finalised, Ends.
lapcountfreePer updateCurrent lap and total laps remaining.
driverlistfreePer updateDriver number, TLA, full name, team name, team colour.
extrapolatedclocklivePer updateSession countdown clock with remaining time and extrapolating flag.
sessioninfolivePer updateSession metadata: circuit, event, type, start/end dates, GMT offset.
sessiondatalivePer updateAccumulated session results, lap series, status series.

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

sessionstatusSession Statusfree

Per update

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

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

lapcountLap Countfree

Per update

Current lap and total laps remaining.

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

driverlistDriver Listfree

Per update

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

Sample payload
json
{
  "feed": "driverlist",
  "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"
    }
  ]
}

extrapolatedclockExtrapolated Clocklive

Per update

Session countdown clock with remaining time and extrapolating flag.

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

sessioninfoSession Infolive

Per update

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

Sample payload
json
{
  "feed": "sessioninfo",
  "sessionId": "9560",
  "utc": "2026-06-08T14:32:18.441Z",
  "data": {
    "sessionKey": 9560,
    "sessionType": "Race",
    "sessionName": "Race",
    "startDate": "2026-06-08T13:00:00",
    "endDate": "2026-06-08T15:00:00",
    "gmtOffset": "02:00:00",
    "path": "2026/2026-06-08_Monaco_Grand_Prix/2026-06-08_Race/",
    "meeting": {
      "key": 1242,
      "name": "Monaco Grand Prix",
      "officialName": "FORMULA 1 GRAND PRIX DE MONACO 2026",
      "location": "Monaco",
      "country": {
        "key": 27,
        "code": "MON",
        "name": "Monaco"
      },
      "circuit": {
        "key": 1,
        "shortName": "Monaco"
      }
    }
  }
}

sessiondataSession Datalive

Per update

Accumulated session results, lap series, status series.

Sample payload
json
{
  "feed": "sessiondata",
  "sessionId": "9560",
  "utc": "2026-06-08T14:32:18.441Z",
  "data": {
    "series": [
      {
        "utc": "2026-06-08T13:00:00.000Z",
        "lap": 1
      },
      {
        "utc": "2026-06-08T14:32:18.000Z",
        "lap": 42
      }
    ],
    "statusSeries": [
      {
        "utc": "2026-06-08T13:00:05.000Z",
        "trackStatus": "1"
      },
      {
        "utc": "2026-06-08T14:22:31.000Z",
        "trackStatus": "4"
      }
    ]
  }
}
← Feed catalogTiming & Lap Data →