---
title: "Get Feed Catalog"
method: GET
path: "/v1/feeds"
tags: ["Feeds"]
---

# Get Feed Catalog

`GET /v1/feeds`

## Request

- Base URL: `https://api.racehooks.io`
- URL: `https://api.racehooks.io/v1/feeds`
- Auth: none declared

List all subscribable motorsport timing feeds. Use the `feedId` when creating a webhook subscription.

**Free tier feeds:**
- `session.status` — Session lifecycle: Started, Aborted, Finished, Finalised, Ends.
- `session.track-status` — Track flag code: 1=Clear, 2=Yellow, 4=SC, 5=Red, 6=VSC, 7=VSC Ending.
- `weather.data` — Air/track temp, humidity, pressure, wind, rainfall.
- `session.lap-count` — Current lap and total laps remaining.
- `driver.list` — Driver number, TLA, full name, team name, team colour.

**Developer feeds (live):**
- `timing.data` — Per-driver position, gaps (leader + interval), lap/sector times, speed traps, pit status.
- `timing.stats` — Personal best lap, best sectors, speed trap rankings.
- `timing.lap-history` — Accumulated per-driver lap data series.
- `timing.driver-info` — Per-driver position, gap, interval, pit stops, overtake state.
- `tire.current` — Current compound per driver with age and new-set flag.
- `tire.history` — Full stint history: compound, start lap, laps on tyre.
- `tire.stints` — Each driver's complete stint list: compound, new set, tyre age, laps, best lap; plus grid slot.
- `pit.lane-times` — Pit stop durations in milliseconds with pit-in/out laps.
- `pit.stops` — Official F1 single pit-stop record (authoritative, arrives after the live stop).
- `pit.stop-series` — Full pit-stop history per driver.
- `session.clock` — Session countdown clock with remaining time and extrapolating flag.
- `weather.data-series` — Time-series history of weather data.
- `race-control.messages` — Raw FIA race control messages: safety car, VSC, red flag, penalties, investigations.
- `regulatory.stewards-decision` — Parsed FIA stewards decisions: penalty type, driver, session, infringement, grid places / seconds / fine, raw decision text.
- `race.grid-penalty` — Grid-affecting stewards decisions only (grid drop, back of grid, pit-lane start), with the number of grid places.
- `session.info` — Session metadata: circuit, event, type, start/end dates, GMT offset.
- `telemetry.driver-tracker` — Low-resolution live position (x/y/z).
- `telemetry.track-position` — Every car's live position on the circuit — lap fraction plus x/y track coordinates — reconstructed each second from timing.
- `timing.top-three` — Simplified live leaderboard for the top three cars — position, driver, lap time, and gap. Zero-dependency feed for tickers and score overlays.
- `events.race` — RaceHooks-computed synthetic events: overtakes, pit stops, safety cars, fastest laps, retirements, penalties, and more (40+ event types).
- `session.timing` — Aggregated session timing state: flag, lap, clock, qualifying segment, resume time.
- `events.qualifying` — Qualifying-specific synthetic events: lap improvements, eliminations, pole position, front row, session complete.
- `fantasy.scores` — Provisional fantasy points per driver with the full component breakdown, pushed when a score changes. Same computation as the fantasy REST routes.
- `weather.rain-onset` — Fires when rainfall begins at the circuit.
- `weather.rain-cleared` — Fires when rainfall stops at the circuit.

**Analytics feeds (Custom tier):**
- `radio.transcript` — Team radio speech, transcribed: what the driver and pit wall actually said, with a confidence score.
- `standings.projection` — Live championship points simulation: projected standings if the current race order holds.
- `results.classification` — Post-race classified positions (fires once after race end).
- `timing.mini-sectors` — High-granularity timing companion: mini-sector progress ticks, speed-trap readings (I1, I2, FL, ST), and live pit/retirement flags.
- `results.race-summary` — Post-race telemetry summary with aggregate metrics and links to full telemetry endpoints.
- `analytics.strategy` — Per-driver decision surfaces: pit (probability, window, plan, call), threat (undercut/overcut/overtake), pace (LTOE, clean pace, tyre health), reliability (DNF risk); plus session-level raceState (safety car probability, strategy leverage, pit-cycle openness T(L)).
- `strategy.recommendation` — Prescriptive counterfactual strategy ranking for the front-runners: candidate pit-and-compound schedules simulated under common random numbers and ranked by outcome distribution — P(win), P(podium), expected finish, expected championship points, p10–p90 robustness spread — with the emergent-strategy baseline for honest comparison.
- `analytics.race-odds` — Monte Carlo position distribution, podium/points odds, expected points, fastest-lap probability, H2H vs teammate, and same-team pairs — plus, during the opening laps, the glass-box combined win-prob line (model prior pooled with the pre-race market line) that anchors the early race.
- `analytics.true-pace` — Who's genuinely fastest: each car's session pace stripped of fuel load, tyre age, and traffic (dirty air), ranked — the public-data proxy for hidden long-run pace.
- `analytics.gap-projection` — Projected gap to the race leader at race end for every driver: five percentile bands (p10–p90) plus P(lapped) from Monte Carlo simulation.
- `analytics.winning-margin` — Session-level race outlook: projected winning margin (P1–P2) with percentile bands, the probability the margin lands above 5s / 10s / below 3s, and the safety-car collapse risk that resets the lead.
- `analytics.race-preview` — Pre-race projections in two stages: post-final-practice (long-run pace ranking, circuit strategy priors, weather outlook) and post-qualifying (classification with measured pole margin, pace-vs-grid deltas, derived race distance, pre-race pit-stop-count distributions, and — when a market line is available — the glass-box combined win-prob line pooling the model prior with the market).
- `analytics.race-duration` — Projected total race time with p10/p90 bands, expected winner lap time, red-flag probability, and P(race exceeds the 2-hour FIA limit).
- `analytics.tire-strategy` — Next-compound probabilities for drivers approaching a pit window (pitStopProbabilityNext3Laps > 0.25 — the within-3 scale, not the per-lap pitStopProbability). Sparse — fires only when relevant.
- `analytics.team-points` — Constructor-level expected points from discrete joint position-distribution convolution, with P(both drivers score) and full points distribution.
- `analytics.championship-probability` — Post-race championship win probability for every driver (WDC) and constructor (WCC). afterRaceId identifies which race the data reflects.
- `analytics.qualifying` — Per-sector fastest probabilities and per-driver pace deltas during qualifying, with pole-margin probability. Fires after each personal best.
- `analytics.sector-pace` — Per-sector pace deltas with anomaly detection; fires when a sector-pace anomaly is detected.
- `analytics.battle` — On-track battle status between a driver and the car directly ahead (closing, holding, defending).
- `analytics.pit-window` — Pit-window status (OPEN / URGENT) combining pit probability, undercut viability, tyre cliff risk, and gap context.
- `analytics.track-conditions` — Track evolution and grip-condition analytics derived from field pace trends.
- `analytics.pit-quality` — Pit-stop execution quality assessment (stationary time vs. expected) after a stop completes.
- `weather.strategy-divergence` — Fires during active rain when the field splits between wet and dry compound strategies.
- `weather.compound-crossover` — Fires when forecast conditions cross the threshold where a different compound becomes optimal.
- `weather.forecast-update` — Fires when precipitation forecast changes by more than 0.5 mm/hr.
- `weather.tire-mismatch` — Per-driver alert when a car is on slicks with rain falling or imminent — the wrong tyre for the conditions.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Feed catalog

- object: Feed catalog
  - `data` object
    - `feeds` object[]
      - `feedId` string
      - `name` string
      - `availability` 'free' | 'live' | 'analytics' | 'enterprise': Minimum subscription tier required to subscribe to this feed
    - `total` integer
    - `limit` integer
    - `offset` integer

---

[API](https://skmtc.dev/racehooks/apis/racehooks-api.md) · [All operations](https://skmtc.dev/racehooks/apis/racehooks-api/llms.txt) · [OpenAPI document](https://skmtc.dev/racehooks/apis/racehooks-api/revisions/2335b73f46e4?raw)