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
The value of the position 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" 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" 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",
"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"
}
}
},
.
.
.
]
}
]
}
}
}