Feed Catalog›Race Control

Race Control

freelive

Official race-direction output, delivered verbatim. race-control.messages is the raw FIA feed — safety car, VSC, red flag, track-limits warnings, overtake-system toggles, penalties, and steward decisions — and is often the most commercially important feed for in-play products. session.track-status carries the live flag code.

For pre-parsed structured events derived from these messages (investigation.opened, penalty.applied, lap.time.deleted, overtake.enabled, …) see the Race Events reference →

Feed IDTierCadenceDescription
session.track-statusfreePer updateTrack flag code: 1=Clear, 2=Yellow, 4=SC, 5=Red, 6=VSC, 7=VSC Ending.
race-control.messageslivePer updateRaw FIA race control messages: safety car, VSC, red flag, penalties, investigations.

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

session.track-statusTrack Statusfree

Per update

Track flag code: 1=Clear, 2=Yellow, 4=SC, 5=Red, 6=VSC, 7=VSC Ending.

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

race-control.messagesRace Control Messageslive

Per update

Raw FIA race control messages: safety car, VSC, red flag, penalties, investigations.

Each delivery is a batch of all messages since the last update — dedupe on utc.

FieldTypeDescription
messages[].utcstringISO 8601 timestamp from the F1 timing server.
messages[].categorystring"Flag" | "Drs" | "SafetyCar" | "Other" — FIA classification.
messages[].messagestringRaw FIA message text.
messages[].flagstring | nullFlag state if applicable: "SAFETY_CAR" | "VIRTUAL_SAFETY_CAR" | "RED" | "CLEAR" etc.
messages[].lapnumber | nullRace lap when the message was issued.
Sample payload
json
{
  "feed": "race-control.messages",
  "sessionId": "9560",
  "utc": "2026-06-08T14:32:18.441Z",
  "data": {
    "messages": [
      {
        "utc": "2026-06-08T14:22:31.000Z",
        "category": "Flag",
        "message": "SAFETY CAR DEPLOYED",
        "flag": "SAFETY_CAR",
        "lap": 42
      },
      {
        "utc": "2026-06-08T13:58:00.000Z",
        "category": "Other",
        "message": "TURN 6 - INCIDENT INVOLVING CARS 4 (NOR) AND 63 (RUS) NOTED - NO FURTHER ACTION",
        "flag": "CLEAR",
        "lap": 21
      }
    ]
  }
}
← Strategy & TyresRace Events →