Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

F1 FAQs

Frequently asked questions for Formula 1 v2

Click on the categories below or browse questions on the right panel.

Categories

.


Coverage


What races are covered in the F1 API?

The entire F1 Championship. For a more detailed breakdown, reference our Coverage Matrix.


Are events updated in real-time?

No, the F1 API provides lap by lap updates.


Does this API include Qualifying and Practice sessions?

Yes, qualifying stages are all covered lap by lap. Practice sessions are updated post-session.



Integration


What format are date fields presented in?

When we present date only values we present these in the ISO 8601 standard format.

ex: 2013-04-03

We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601


What format are the date/time fields presented in?

All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.

ex: 2013-04-03T18:15:00+00:00

For more information: https://en.wikipedia.org/wiki/ISO_8601


How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or
cache-control: public, must-revalidate, max-age=120


How do I know what 'stage' I am currently looking at?

Each stage has a stage element. The stage element has an attribute type which displays the stage type. The valid stage types are listed here.

<stage id="sr:stage:686254" description="Australian Grand Prix 2021" scheduled="2021-11-19T01:30:00+00:00" 
scheduled_end="2021-11-21T08:00:00+00:00" type="event" status="Cancelled" single_event="false">
"stages": [
    {
        "id": "sr:stage:686254",
        "description": "Australian Grand Prix 2021",
        "scheduled": "2021-11-19T01:30:00+00:00",
        "scheduled_end": "2021-11-21T08:00:00+00:00",
        "type": "event",
        "status": "Cancelled",
        "single_event": false,
        "venue": {
            "id": "sr:venue:1011",
            "name": "Melbourne Grand Prix Circuit",
            "city": "Melbourne",
            "country": "Australia",
            "coordinates": "-37.840089,144.953527",
            "country_code": "AUS",
            "length": 5303,
            "url_official": "http://www.grandprix.com.au",
            "debut": 1996,
            "curves_left": 6,
            "curves_right": 10,
            "laps": 58,
            "timezone": "Australia/Melbourne"
        },
        "stages": [
            {
                "id": "sr:stage:686256",
                "description": "Practice 1",
                "scheduled": "2021-11-19T01:30:00+00:00",
                "scheduled_end": "2021-11-19T02:30:00+00:00",
                "type": "practice",
                "single_event": false
            },
            {
                "id": "sr:stage:686258",
                "description": "Practice 2",
                "scheduled": "2021-11-19T05:00:00+00:00",
                "scheduled_end": "2021-11-19T06:00:00+00:00",
                "type": "practice",
                "single_event": false
            },
            {
                "id": "sr:stage:686260",
                "description": "Practice 3",
                "scheduled": "2021-11-20T03:00:00+00:00",
                "scheduled_end": "2021-11-20T04:00:00+00:00",
                "type": "practice",
                "single_event": false
            },
            {
                "id": "sr:stage:686262",
                "description": "Qualification",
                "scheduled": "2021-11-20T06:00:00+00:00",
                "scheduled_end": "2021-11-20T07:00:00+00:00",
                "type": "qualifying",
                "single_event": false,
                "stages": [
                    {
                        "id": "sr:stage:686264",
                        "description": "Q1",
                        "scheduled": "2021-03-20T00:00:00+00:00",
                        "scheduled_end": "2021-03-20T00:00:00+00:00",
                        "type": "qualifying_part",
                        "single_event": false
                    },
                    {
                        "id": "sr:stage:686266",
                        "description": "Q2",
                        "scheduled": "2021-03-20T00:00:00+00:00",
                        "scheduled_end": "2021-03-20T00:00:00+00:00",
                        "type": "qualifying_part",
                        "single_event": false
                    },
                    {
                        "id": "sr:stage:686268",
                        "description": "Q3",
                        "scheduled": "2021-03-20T00:00:00+00:00",
                        "scheduled_end": "2021-03-20T00:00:00+00:00",
                        "type": "qualifying_part",
                        "single_event": false
                    }
                ]
            },
            {
                "id": "sr:stage:686270",
                "description": "Race",
                "scheduled": "2021-11-21T06:00:00+00:00",
                "scheduled_end": "2021-11-21T08:00:00+00:00",
                "type": "race",
                "single_event": false
            }
        ]
    },

How do I retrieve information about an individual driver?

Use the Competitor Profile endpoint with the required driver's competitor ID. The best place to get the driver's competitor ID is the Stage Summary endpoint, using the season stage ID.



Stage Types


What are the valid stage types?

  • sport
  • season
  • event
  • practice
  • qualifying
  • qualifying_part
  • sprint_race
  • race
  • lap


Stage & Driver Statuses


What are the valid stage and driver statuses?

Stage Status

  • Completed
  • Closed
  • Running
  • Cancelled
  • Finished
  • Not Started
  • Red flag
  • Yellow flag
  • Red and yellow flag
  • White flag
  • Safety car
  • Warmup
  • In grid

Stage Sub Status

  • 2 hour rule
  • 75% rule
  • All laps completed
  • Entire track

Driver Status

  • Pit stop
  • Finished
  • Disqualified
  • Did not start
  • Out
  • In race

Driver Sub Status

  • Unknown
  • Retired


Probabilities


How do I get probabilities for the entire Championship? Or only one race?

You can use season, event, and race stage IDs as parameters for the Stage Probabilities endpoint.

Probabilities are available for the individual driver to win the season, a single event, and race stage. Probabilities are not available on the Sport, Practice, Qualifying, or Lap stages.



Standings


How do I see the Championship points table?

Use the Stage Summary endpoint and a season stage ID as the parameter. The competitors node lists competitors, ranked with points, position, victories, races, races with points, and podiums.

<competitors>
    <competitor id="sr:competitor:178318" name="Verstappen, Max" gender="male" nationality="Netherlands" country_code="NLD">
        <team id="sr:competitor:4978" name="Red Bull Racing" gender="male" nationality="Austria" country_code="AUT"/>
        <result points="524" car_number="1" position="1" victories="17" races="20" races_with_points="20" polepositions="11" podiums="19" fastest_laps="8" victory_pole_and_fastest_lap="5"/>
    </competitor>
    <competitor id="sr:competitor:46337" name="Perez, Sergio" gender="male" nationality="Mexico" country_code="MEX">
        <team id="sr:competitor:4978" name="Red Bull Racing" gender="male" nationality="Austria" country_code="AUT"/>
        <result points="258" car_number="11" position="2" victories="2" races="20" races_with_points="17" polepositions="2" podiums="8" fastest_laps="2"/>
    </competitor>
    <competitor id="sr:competitor:7135" name="Hamilton, Lewis" gender="male" nationality="Great Britain" country_code="GBR">
        <team id="sr:competitor:41127" name="Mercedes AMG Motorsport" gender="male" nationality="Germany" country_code="DEU"/>
        <result points="226" car_number="44" position="3" races="20" races_with_points="19" polepositions="1" podiums="6" fastest_laps="4"/>
    </competitor>



🙋

More questions?

Reach out to [email protected] for further assistance.