Introduction
The Formula 1 API provides schedules and live coverage for all F1 Championship races.
Select the Formula 1 package in our Coverage Matrix for events and data offered.
This API uses a descending, stage-based structure. By changing the stage ID, you can retrieve information on a season, event, race, or any of the practice or qualifying stages.
Additional feeds provide complementary stats, including:
- Racer profiles
- Team profiles
- Race and Championship win probabilities
Authentication is required for all API calls.
Stage Format
The core of this API is built around the concept of stages. For example, an event may contain the following stage types: practice, qualifying, and race. Each of those stages, in turn, have stages. The IDs of each stage are usable in the Stage Summary path to request information about that particular stage.
See the below Stage Types table for all available stage types, their sub-stages, and their definitions.
The best way to start the navigation with the F1 API is the Seasons endpoint. From there, obtain the stage ID for the season required and use that in the Stage Summary as a starting point into the sub-stages.
Stage Types
| Stage Type | Information Included | Sub-stages |
|---|---|---|
Sportsportsr:stage:7668 | Information about the seasons included. Which is limited to the current and previous season only. *Note probabilities do not return valid data on this stage. | Formula 1 seasons |
Seasonseason | Contains the season schedule, driver and team standings and statistics. | Events on the F1 calendar for that season (eg, Melbourne Grand Prix, Abu Dhabi Grand Prix) |
Eventevent | Information about a single event, the competitors, the teams, and the circuit. | Sessions (eg, Practice, Qualifying, Race) |
Practicepractice | Competitors and results of practice such as fastest time etc. | None |
Qualifyingqualifying | Information pertaining to the qualifying stage of the event including conditions, competitors, and overall qualifying results. | Qualifying Parts |
Qualifying Partqualifying_part | Information about the individual qualifying parts of the overall qualifying stage such as conditions, competitors, and results. | None |
Sprint Racesprint_race | Details of a sprint race including the competitors, laps, and results. | Laps |
Racerace | Details of the race itself including the competitors, lap by lap, and overall results. | Laps |
Laplap | Specific details on individual laps such as driver positions, times, etc. Note probabilities do not return valid data on this stage. | None |
API Map
Endpoint Descriptions
Competition Merge Mappings - Provides the valid Sportradar Id in cases when two competitors have been merged into one.
Competitor Profile - Provides detailed driver information including debut date, first points, first pole, and first victory.
Deleted Stages - Provides all detailed stages within a given season.
Seasons - Provides a complete historical list of available seasons for F1. This is the starting point for the Formula 1 API.
Stage Probabilities - Provides the outrights for each driver for a given race.
Stage Schedule - Provides the schedule for a given stage.
Stage Summary - Provides schedules and results information based on the stage provided (sport, season, event, practice, qualifying, qualifying part, race, or lap).
Team Profile - Provides detailed team information including car details, engine type, debut date, first points, first pole, first victory, and relevant staff information.
Data Retrieval Sample
To find the win probabilities for a given race:
- Call the Seasons endpoint and find the Stage Id for the current season
- Call the Stage Schedule using the 'season' Stage Id
- Locate the Stage Id for the upcoming race
- Call the Stage Probabilities using the 'race' Stage Id
- Within the results locate the win probability for each racer
The probability of a win for each racer is displayed.
Integration Links
OpenAPI Spec
Our Formula 1 API is available via OpenAPI. Click below to view and/or download the spec.
Postman Workspace
Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Formula 1 API collection.
Feel free to follow and/or fork any collections to receive updates.
Schema Download
Open the zip file below to access our entire Formula 1 API XSD schema.