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"
},
.
.
.
]
}
]
}
}
}