Race Results
To list the results for a specific race use the following URL with the required year and round number:
http://ergast.com/api/f1/2008/5/results
If the results for the specified race are not yet available the RaceTable element in the response will be empty.
Results from the most recent race can always be obtained using the following static URL:
http://ergast.com/api/f1/current/last/results
Results can also be listed using one or more of the following criteria:
/circuits/<circuitId>
/constructors/<constructorId>
/drivers/<driverId>
/grid/<position>
/fastest/<rank>
/status/<statusId>
For example, to list all the results for a specific driver in a particular season:
http://ergast.com/api/f1/2008/drivers/alonso/results
Or to list all the results for a specific driver when driving for a particular constructor:
http://ergast.com/api/f1/drivers/alonso/constructors/renault/results
If you are only interested in results in a specific finishing position you can add a qualifier:
http://ergast.com/api/f1/2008/drivers/alonso/results/2
So to list all drivers and constructors winning races in a season:
http://ergast.com/api/f1/2008/results/1
The value of the position attribute in the Result element is always an integer, giving the finishing order of all drivers. The value of the positionText attribute is either an integer (finishing position), “R” (retired), “D” (disqualified), “E” (excluded), “W” (withdrawn), “F” (failed to qualify) or “N” (not classified). Further information is given by the status element.
Fastest Lap Times
Fastest lap times are included from the 2004 season onwards. To obtain the results for the driver who achieves the fastest lap in a race use:
http://ergast.com/api/f1/2010/1/fastest/1/results
The <rank> value refers to how the fastest lap for each driver is ranked in relation to those of other drivers.
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/...">
<RaceName>Australian Grand Prix</RaceName>
<Circuit circuitId="albert_park" url="http://en.wikipedia.org/...">
<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>
<ResultsList>
<Result number="22" position="1" positionText="1" points="10">
<Driver driverId="hamilton" dob="1985-01-07" url="http://...">
<GivenName>Lewis</GivenName>
<FamilyName>Hamilton</FamilyName>
<DateOfBirth>1985-01-07</DateOfBirth>
<DriverNationality>British</DriverNationality>
</Driver>
<Constructor constructorId="mclaren" url="http://...">
<Name>McLaren</Name>
<Nationality>British</Nationality>
</Constructor>
<Grid>1</Grid>
<Laps>58</Laps>
<Status statusId="1">Finished</Status>
<Time millis="5690616">1:34:50.61</Time>
<FastestLap rank="2" lap="39">
<Time>1:27.452</Time>
<AverageSpeed units="kph">218.300</AverageSpeed>
</FastestLap>
</Result>
<Result number="3" position="2" positionText="2" points="8">
<Driver driverId="heidfeld" dob="1977-05-10" url="http://...">
<GivenName>Nick</GivenName>
<FamilyName>Heidfeld</FamilyName>
<DateOfBirth>1977-05-10</DateOfBirth>
<Nationality>German</Nationality>
</Driver>
<Constructor constructorId="bmw_sauber" url="http://...">
<Name>BMW Sauber</Name>
<Nationality>German</Nationality>
</Constructor>
<Grid>5</Grid>
<Laps>58</Laps>
<Status statusId="1">Finished</Status>
<Time millis="5696094">+5.478</Time>
<FastestLap rank="3" lap="41">
<Time>1:27.739</Time>
<AverageSpeed units="kph">217.586</AverageSpeed>
</FastestLap>
</Result>
.
.
.
</ResultsList>
</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",
"Results": [
{
"number": "22",
"position": "1",
"positionText": "1",
"points": "10",
"Driver": {
"driverId": "hamilton",
"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"
},
"grid": "1",
"laps": "58",
"status": "Finished",
"Time": {
"millis": "5690616",
"time": "1:34:50.616"
},
"FastestLap": {
"rank": "2",
"lap": "39",
Time: {
"time": "1:27.452"
},
"AverageSpeed": {
"units": "kph"
"speed": "218.300"
}
}
},
.
.
.
]
}
]
}
}
}