List all available RaceHooks data feeds, including which subscription tier each feed requires. The special 'events.race' feed is a synthetic feed that emits structured events (overtakes, pit stops, safety cars, etc.) derived from multiple raw feeds.
输入参数limit
list_webhooks
List Webhooks
List all webhook subscriptions for the authenticated RaceHooks account.
输入参数limitoffset
Get a single webhook subscription by ID.
输入参数webhookId必填
create_webhook
Create Webhook
Register a new webhook subscription. Returns the webhook and the HMAC signing secret (shown once — store it immediately).
输入参数feedId必填filterswebhookUrl必填webhookMethod
update_webhook
Update Webhook
Update an existing webhook subscription. Use active: false to pause delivery, active: true to resume. Can also update the endpoint URL, HTTP method, or filters without deleting and recreating the webhook.
输入参数activefilterswebhookId必填webhookUrlwebhookMethod
delete_webhook
Delete Webhook
Permanently delete a webhook subscription.
输入参数webhookId必填
Send a test payload to a webhook endpoint immediately. Useful for verifying your server is reachable and your HMAC verification code is correct.
输入参数webhookId必填
get_webhook_logs
Get Webhook Logs
Retrieve recent delivery logs for a webhook — shows status codes, retry counts, and payload excerpts.
输入参数limitwebhookId必填
get_webhook_secret
Get Webhook Secret
Retrieve the current HMAC signing secret for a webhook.
输入参数webhookId必填
rotate_webhook_secret
Rotate Webhook Secret
Rotate the HMAC signing secret for a webhook. The old secret is invalidated immediately — update your server before calling this. The new secret is shown once.
输入参数webhookId必填
get_live_session
Get Live Session
Get the current live session state: flag status, lap number, driver positions, intervals, tyre compounds, and recent race control messages. Returns an empty/inactive context when no session is live. Live per-driver timing requires Developer or higher; Free receives the latest milestone classification (end of a qualifying segment or the final result) instead.
无需输入参数。
List events (race weekends) for the current or a specific season, including session schedules and status.
输入参数yearlimitupcoming
get_subscription
Get Subscription
Get the current subscription tier, plan limits (webhooks, deliveries, HMAC, analytics enrichment), and live usage snapshot for this account.
无需输入参数。
Get delivery usage summary for the current period: total deliveries, failures, tier, and remaining monthly delivery bucket.
无需输入参数。
get_usage_by_feed
Get Usage By Feed
Get webhook delivery counts broken down by feed for the current period. Useful for identifying which feeds are driving delivery volume.
无需输入参数。
get_usage_latency
Get Usage Latency
Get webhook delivery latency percentiles (p50, p95, p99) broken down by feed for the current period.
无需输入参数。
get_usage_hourly
Get Usage Hourly
Get webhook delivery volume broken down by hour for the last 24 hours. Useful for identifying traffic spikes.
无需输入参数。
get_usage_history
Get Usage History
Get historical delivery counts and failure rates over past periods.
无需输入参数。
get_billing_plan
Get Billing Plan
Get the detailed billing plan including tier, subscription period end date, limits, and current usage.
无需输入参数。
list_replay_sessions
List Replay Sessions
List recorded sessions that have archived data and can be replayed. Only completed sessions with archive paths are returned. Self-serve tiers (Free and Developer) list the current season only, plus the curated demo session; the full historical archive is on Custom. `restrictedToSeason` in the response reports the applied limit.
输入参数typeyearlimitoffset
get_demo_session
Get Demo Session
Get the curated demo session to replay (the canonical ID of a guaranteed-real event).
无需输入参数。
get_replay_quota
Get Replay Quota
Get the replay delivery quota for this account: distinct-session lifetime slots for your tier.
无需输入参数。
prepare_replay
Prepare Replay
Prepare a session for recorded playback, generating its playback artifact if not already cached. Check readiness with get_replay_status.
输入参数sessionId必填
get_replay_status
Get Replay Status
Check whether a session's playback artifact is ready to stream.
输入参数sessionId必填
List drivers. Available on every plan; page size is capped at 25 on Free and 100 on paid plans.
输入参数limitactiveoffsetsearchnationality
Get a driver profile with career statistics (wins, podiums, poles, championships). Available on every plan.
输入参数driverId必填
get_driver_results
Get Driver Results
Get race-by-race results for a driver. Available on every plan; timing fields (gap, finish time) are only returned on Developer and above.
输入参数limitoffsetseasondriverId必填
get_driver_standings
Get Driver Standings
Get championship standings history for a driver across seasons. Available on every plan.
输入参数seasondriverId必填
list_constructors
List Constructors
List constructors. Available on every plan.
输入参数limitactiveoffsetlineage
get_constructor
Get Constructor
Get a constructor profile including its lineage history (predecessor and successor teams). Available on every plan.
输入参数constructorId必填
get_constructor_results
Get Constructor Results
Get race-by-race results for a constructor. Available on every plan; timing fields (gap, finish time) are only returned on Developer and above.
输入参数limitoffsetseasonconstructorId必填
get_constructor_standings
Get Constructor Standings
Get championship standings history for a constructor across seasons. Available on every plan.
输入参数seasonconstructorId必填
list_circuits
List Circuits
List all F1 circuits with location and coordinates. Available on every plan.
输入参数limitoffsetcountry
Get circuit details and analytics (compound priors, historical pace data). Available on every plan.
输入参数circuitId必填
List all available F1 seasons with race counts. Available on every plan.
无需输入参数。
get_season_standings
Get Season Standings
Get final driver and constructor championship standings for a season. Available on every plan.
输入参数year必填
get_season_races
Get Season Races
List all races in a season with circuit, date, and data quality tier. Available on every plan.
输入参数year必填
Get race details with full results and qualifying grid. Available on every plan; timing fields (gaps, fastest lap, finish time, Q1/Q2/Q3 times) are only returned on Developer and above.
输入参数raceId必填
get_race_qualifying
Get Race Qualifying
Get qualifying results for a race. Available on every plan; Q1/Q2/Q3 times are only returned on Developer and above.
输入参数raceId必填
get_race_pitstops
Get Race Pitstops
Get all pit stop records for a race (driver, stop number, lap, duration). Available on every plan.
输入参数raceId必填
get_race_tyres
Get Race Tyres
Get tyre stint records for a race (driver, stint number, lap range, compound, tyre age). Available on every plan.
输入参数raceId必填
get_race_weather
Get Race Weather
Get lap-by-lap weather data for a race. Available on every plan.
输入参数raceId必填
get_race_laps
Get Race Laps
Get per-lap times and positions for a race. Requires Developer or higher. Optionally filter to a single driver with driverId.
输入参数raceId必填driverId
get_race_summary
Get Race Summary
Get the post-race analytics status and aggregate telemetry metrics for a race. Status is available on every plan; the aggregate metrics are only returned on Developer and above.
输入参数raceId必填
get_race_telemetry_laps
Get Race Telemetry Laps
Get per-lap telemetry metrics (speed, throttle, brake, DRS, aggression) from telemetry data. Requires Developer or higher. Optional driverId to filter to one driver.
输入参数raceId必填driverId
get_race_telemetry_stints
Get Race Telemetry Stints
Get per-stint telemetry metrics and degradation slopes. Requires a Custom plan (not included in Developer).
输入参数raceId必填driverId
get_race_telemetry_aggression
Get Race Telemetry Aggression
Get driver aggression index rankings for a race. Requires a Custom plan (not included in Developer).
输入参数raceId必填
get_session_analytics
Get Session Analytics
Get per-lap ML analytics snapshot for a session (pit probability, SC probability, tyre health, LTOE, win probability). Requires Developer or higher.
输入参数sessionId必填
get_event_pace
Get Event Pace
Get practice and qualifying pace summary per driver for an event. Requires Developer or higher.
输入参数eventId必填
list_insight_races
List Insight Races
List races that have a completed post-race analytics pipeline — i.e. races where get_race_insights will return data. Available on every plan.
输入参数season
get_race_insights
Get Race Insights
Get the full post-race ML analytics bundle for a race. Includes per-driver per-lap outputs: pit stop probability, safety car probability, overtake probability, undercut probability, tyre health, cliff risk and lap prediction, fuel-corrected lap time (LTOE), win probability, expected championship points. Also includes pit stops, tyre stints, lap times, and safety-car lap list. Output depends on plan: Free receives the descriptive data plus tyre state only (compound, tyre life, tyre health); the strategic predictions require Developer or higher.
输入参数raceId必填
get_model_meta
Get Model Meta
Get the public model manifest for each RaceHooks predictive model: what it predicts, its model family, a qualitative calibration tier, when it was last trained, and a changelog. Raw evaluation metrics are not exposed. Available on every plan.
无需输入参数。
get_telemetry_laps
Get Telemetry Laps
Get per-lap telemetry aggregates (avg/max speed, throttle, brake, DRS, aggression index). Returns all drivers by default. Filter with driverId or lapNumber. Requires Developer or higher.
输入参数raceId必填driverIdlapNumber
get_telemetry_driver_laps
Get Telemetry Driver Laps
Get per-lap telemetry for a single driver across all laps of a race. Requires Developer or higher.
输入参数raceId必填driverId必填
get_telemetry_lap_comparison
Get Telemetry Lap Comparison
Get all drivers' telemetry for a single lap — useful for side-by-side lap comparisons. Requires Developer or higher.
输入参数raceId必填lapNumber必填
get_telemetry_race_summary
Get Telemetry Race Summary
Get race-level telemetry summary: max speed, fastest driver, average throttle/brake percentages, top aggression driver. Requires Developer or higher.
输入参数raceId必填
get_fantasy_pit_times
Get Fantasy Pit Times
Get the pit-stop time leaderboard for a session: stationary time (seconds stopped in the box) per stop, with driver code and team. Requires Developer or higher.
输入参数sessionId必填
get_fantasy_scores
Get Fantasy Scores
Get estimated F1 Fantasy points per driver for a completed race. Includes full scoring breakdown: race position points, qualifying points, Q2/Q3 bonuses, positions gained, fastest lap, beat-teammate bonuses, and DNF penalty. Requires Developer or higher.
输入参数raceId必填