Integration Scenarios

These integration scenarios are step-by-step walkthroughs of common Formula 1 API integrations. Each one starts from a practical goal, lists the feeds involved, and works through real request and response snippets end to end.

Each scenario page includes:

The real-world goal and common use cases
The feeds involved and a high-level workflow
Step-by-step requests with real response snippets
A refresh strategy and best practices

If you are new to the stage model, read Fundamentals and Race Status Workflow first; every scenario below builds on them.

Where to Start

If you want to...	Start here
Build a season calendar or session timetable	Pulling Schedules
Show live timing during a race weekend	Tracking Live Races
Display the drivers' and constructors' championships	Tracking Championship Standings
Show win probabilities for a race or the title	Retrieving Race Probabilities
Build driver and team profile pages	Retrieving Competitor and Team Details
Keep stored data current and catch removals	Monitoring Data Changes
Work with past seasons	Historical Data

The Common Pattern

Most scenarios follow the same shape, because navigation runs on stage IDs:

Seasons → (Stage Schedule to find the stage you want) → Stage Summary or Stage Probabilities for that stage

Call Seasons and find the season's stage ID.
Call Stage Schedule (or Stage Summary) to locate the event, session, or lap stage ID you need.
Call the feed for that stage and read the fields relevant to your use case.

The profile feeds take an sr:competitor: ID instead, sourced from the same responses. Each scenario below varies only in which ID you pass and which fields you read.