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.

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

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