Webhooks

Feed Catalog

These are the F1 feeds currently available on RaceHooks. Feeds are delivered as JSON payloads to your registered webhook URLs during active sessions. IndyCar and NASCAR feeds will be documented here as they launch.

ℹ

The feed id values listed here are what you pass to feedId when creating a webhook.

free$0/mo

5 feeds

Session, track, weather, lap, drivers

starter$39/mo

16 feeds

All timing, telemetry, pit, race control

pro$199/mo

3 feeds

Broadcast, audio, championship

Key payload examples

The three most commonly integrated feeds — timing data, car telemetry, and race control messages.

timingdata — per lap

json

{
  "feed": "timingdata",
  "session": "2026 British Grand Prix — Race",
  "lap": 42,
  "data": {
    "1": {
      "position": 1,
      "gap": "—",
      "interval": "—",
      "lastLap": "1:29.104",
      "s1": "28.441",
      "s2": "31.204",
      "s3": "29.459",
      "compound": "MEDIUM",
      "tireAge": 22,
      "inPit": false,
      "pitOut": false
    },
    "4": {
      "position": 2,
      "gap": "+4.821",
      "interval": "+4.821",
      "lastLap": "1:29.381",
      "compound": "HARD",
      "tireAge": 8
    }
  }
}

cardata — ~270ms telemetry

json

{
  "feed": "cardata",
  "session": "2026 British Grand Prix — Race",
  "timestamp": "2026-07-06T14:22:31.102Z",
  "entries": [
    {
      "driverNumber": "1",
      "speed": 307,
      "throttle": 97,
      "brake": false,
      "gear": 7,
      "rpm": 11842,
      "drs": 12
    },
    {
      "driverNumber": "4",
      "speed": 298,
      "throttle": 94,
      "brake": false,
      "gear": 7,
      "rpm": 11719,
      "drs": 12
    }
  ]
}

racecontrolmessages — per event

json

{
  "feed": "racecontrolmessages",
  "session": "2026 British Grand Prix — Race",
  "message": {
    "Utc": "2026-07-06T14:31:08.000Z",
    "Lap": 42,
    "Category": "SafetyCar",
    "Flag": "SC",
    "Message": "SAFETY CAR DEPLOYED",
    "Mode": "SAFETY CAR"
  }
}

5 feeds

free

Feed ID	Name	Cadence	Description
`sessionstatus`	Session Status	Per event	Session lifecycle events: Inactive, Started, Aborted, Finished, Finalised. Use this to know when timing data is valid.
`trackstatus`	Track Status	Per event	Track condition code and message: 1 (All Clear), 2 (Yellow), 3 (SC), 4 (SC ending), 5 (Red), 6 (VSC), 7 (VSC ending).
`weatherdata`	Weather Data	~60 seconds	Air and track temperature, humidity, wind speed and direction, pressure, and rainfall boolean.
`lapcount`	Lap Count	Per lap	Current lap number, total laps, and current lap fraction. Use for race progress displays.
`driverlist`	Driver List	Per session	Full driver roster with number, TLA, full name, team name, and team colour hex code.

Timing & position

starter

Feed ID	Name	Cadence	Description
`timingdata`	Timing Data	Per lap	The primary timing feed. Per-driver lap times, sector times, gap-to-leader, interval-to-car-ahead, current position, and pit out/in status. Updates on every lap completion and intra-lap events.
`timingstats`	Timing Stats	Per sector	Best lap, best sector times, speed trap readings (I1, I2, FL, ST). Personal bests flagged. Used for timing tower overlays.
`timingappdata`	Timing App Data	Per sector	DRS detection state and activation, mini-sector times, stint gap data. Primarily used by the official F1 app.
`position`	Position Data	~250ms	Real-time x/y/z track coordinates for all 20 cars at approximately 4 Hz. Use for live circuit map visualizations.
`lapseries`	Lap Series	Per lap	Accumulated lap data series per driver. Useful for building lap-by-lap history within a session.
`topthree`	Top Three	Per lap	Simplified live leaderboard for the top 3 cars — position, driver, gap. Zero-dependency overlay feed.
`driverraceinfo`	Driver Race Info	Per event	Per-driver race status, gap-to-leader, interval, OvertakeMode status, and grid position. Updates on position changes and incidents.
`sessioninfo`	Session Info	Per session	Session metadata: circuit name, event name, session type, start date/time, GMT offset, and session key.
`sessiondata`	Session Data	Per event	Accumulated session results — positions, lap counts, retirements. Builds toward the full classification.

Car telemetry

starter

Feed ID	Name	Cadence	Description
`cardata`	Car Data	~270ms	Per-car telemetry at approximately 3.7 Hz: Speed (km/h), Throttle (0–100), Brake (boolean), Gear (0–8), RPM, and DRS state (0, 8, 10, 12, 14 — where 12/14 = open). Compressed payload (~3KB per update).

Strategy & pit data

starter

Feed ID	Name	Cadence	Description
`currenttyres`	Current Tyres	Per pit stop	Current compound fitted per driver and whether a new tyre set was used.
`tyrestintseries`	Tyre Stint Series	Per pit stop	Full stint history: compound, lap fitted, total laps on tyre for each stint. Builds the complete strategy picture.
`pitlanetimecollection`	Pit Lane Times	Per pit stop	Pit stop duration in milliseconds, with pit-in and pit-out lap numbers.

Race control & events

starter

Feed ID	Name	Cadence	Description
`racecontrolmessages`	Race Control Messages	Per event	Official race control messages: safety car, VSC, red flag, DRS enabled/disabled, track limits warnings, penalties, and steward decisions. Often the most commercially important feed for in-play betting.
`raceevent`	Race Events	Per event	Synthetic feed generated by RaceHooks from raw timing data. Delivers structured, pre-detected events: overtakes, pit stops, lead changes, safety cars, fastest laps, retirements, session transitions, and qualifying hot laps. See the Race Events reference for the full event type schema.

Broadcast & communication

starter

Feed ID	Name	Cadence	Description
`teamradio`	Team Radio	Per clip	Team radio audio clip metadata: driver number, UTC timestamp, and a signed URL to the audio file. Clips are available for approximately 24 hours.

Specialist feeds

pro

Feed ID	Name	Cadence	Description
`spfeed`	Special Programme	Per event	Broadcast programme feed. Used for official broadcast overlay data and special events (presentations, awards). Rarely contains data outside official broadcast windows.
`audiostreams`	Audio Streams	Per session	Audio stream manifests for multi-language team radio and session audio. Returns HLS manifest URLs.
`championshipprediction`	Championship Prediction	Per session	Live championship points simulation: projected points if the current race order held to the end. Useful for broadcaster championship narrative overlays.

ℹ

Analytics-enriched payload fields (analytics.*) are available on the Analytics tier ($499/mo) and are injected onto timingdata, cardata, and tyrestintseries payloads automatically. See the Analytics reference.

← Quickstart Analytics reference →