Qualifying Results

Note: Qualifying results are only fully supported from the 2003 season onwards.

To list the qualifying results for a specific race use the following URL with the required year and round number:

http://ergast.com/api/f1/2008/5/qualifying

If the qualifying results for the specified race are not available the RaceTable element in the response will be empty.

Note that the starting grid positions may be different to the qualifying positions, due to penalties or mechanical problems. The starting grid positions are recorded in the grid field in the Race Results.

Qualifying results can be filtered using one or more of the following criteria:

/circuits/<circuitId>
/constructors/<constructorId>
/drivers/<driverId>
/grid/<position>
/results/<position>
/fastest/<rank>
/status/<statusId>

For example, to list all the qualifying results for a specific driver in a particular season:

http://ergast.com/api/f1/2008/drivers/alonso/qualifying

Or to list all the qualifying results for a specific driver when driving for a particular constructor:

http://ergast.com/api/f1/drivers/alonso/constructors/renault/qualifying

If you are only interested in qualifying results with a specific finishing position you can add a qualifier:

http://ergast.com/api/f1/2008/qualifying/1

XML Example Response

<?xml version="1.0" encoding="utf-8"?>
<MRData xmlns="http://ergast.com/mrd/1.0" series="f1" limit="30" offset="0" total="22">
    <RaceTable season="2008" round="1">
        <Race season="2008" round="1" url="http://en.wikipedia.org/wiki/2008_Australian...">
            <RaceName>Australian Grand Prix</RaceName>
            <Circuit circuitId="albert_park" url="http://en.wikipedia.org/wiki/Melbourn...">
                <CircuitName>Albert Park Grand Prix Circuit</CircuitName>
                <Location lat="-37.8497" long="144.968">
                    <Locality>Melbourne</Locality>
                    <Country>Australia</Country>
                </Location>
            </Circuit>
            <Date>2008-03-16</Date>
            <Time>04:30:00Z</Time>
            <QualifyingList>
                <QualifyingResult number="22" position="1">
                    <Driver driverId="hamilton" code="HAM" url="http://en.wikiped...">
                        <PermanentNumber>44</PermanentNumber>
                        <GivenName>Lewis</GivenName>
                        <FamilyName>Hamilton</FamilyName>
                        <DateOfBirth>1985-01-07</DateOfBirth>
                        <Nationality>British</Nationality>
                    </Driver>
                    <Constructor constructorId="mclaren" url="http://en.wikipedia.org/w...">
                        <Name>McLaren</Name>
                        <Nationality>British</Nationality>
                    </Constructor>
                    <Q1>1:26.572</Q1>
                    <Q2>1:25.187</Q2>
                    <Q3>1:26.714</Q3>
                </QualifyingResult>
                <QualifyingResult number="4" position="2">
                    <Driver driverId="kubica" code="KUB" url="http://en.wikipedia...">
                        <GivenName>Robert</GivenName>
                        <FamilyName>Kubica</FamilyName>
                        <DateOfBirth>1984-12-07</DateOfBirth>
                        <Nationality>Polish</Nationality>
                    </Driver>
                    <Constructor constructorId="bmw_sauber" url="http://en.wikipedia.or...">
                        <Name>BMW Sauber</Name>
                        <Nationality>German</Nationality>
                    </Constructor>
                    <Q1>1:26.103</Q1>
                    <Q2>1:25.315</Q2>
                    <Q3>1:26.869</Q3>
                </QualifyingResult>
                    .
                    .
                    .
            </QualifyingList>
        </Race>
    </RaceTable>
</MRData>

JSON Example Response

{
  "MRData": {
    "xmlns": "http://ergast.com/mrd/1.0",
    "series": "f1",
    "limit": "30",
    "offset": "0",
    "total": "22",
    "RaceTable": {
      "season": "2008",
      "round": "1",
      "Races": [
        {
          "season": "2008",
          "round": "1",
          "url": "http://en.wikipedia.org/wiki/2008_Australian_Grand_Prix",
          "raceName": "Australian Grand Prix",
          "Circuit": {
            "circuitId": "albert_park",
            "url": "http://en.wikipedia.org/wiki/Melbourne_Grand_Prix_Circuit",
            "circuitName": "Albert Park Grand Prix Circuit",
            "Location": {
              "lat": "-37.8497",
              "long": "144.968",
              "locality": "Melbourne",
              "country": "Australia"
            }
          },
          "date": "2008-03-16",
          "time": "04:30:00Z",
          "QualifyingResults": [
            {
              "number": "22",
              "position": "1",
              "Driver": {
                "driverId": "hamilton",
                "permanentNumber": "44",
                "code": "HAM",
                "url": "http://en.wikipedia.org/wiki/Lewis_Hamilton",
                "givenName": "Lewis",
                "familyName": "Hamilton",
                "dateOfBirth": "1985-01-07",
                "nationality": "British"
              },
              "Constructor": {
                "constructorId": "mclaren",
                "url": "http://en.wikipedia.org/wiki/McLaren",
                "name": "McLaren",
                "nationality": "British"
              },
              "Q1": "1:26.572",
              "Q2": "1:25.187",
              "Q3": "1:26.714"
            },
            .
            .
            .
          ]
        }
      ]
    }
  }
}

Back to documentation index