Race Schedule
To obtain the schedule of races for a specific season use the following URL with the required year:
The schedule for the current season can always be obtained using the following static URL:
http://ergast.com/api/f1/current
To obtain information about a specific race add the round number:
http://ergast.com/api/f1/2008/5
Race lists can be filtered by adding one or more of the following criteria followed by "/races":
/circuits/<circuitId>
/constructors/<constructorId>
/drivers/<driverId>
/grid/<position>
/results/<position>
/fastest/<rank>
/status/<statusId>
For example, to list all races where a specific driver has driven at a particular circuit:
http://ergast.com/api/f1/drivers/alonso/circuits/monza/races
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="18">
<RaceTable season="2008">
<Race season="2008" round="1" url="http://en.wikipedia.org/...">
<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-18</Date>
<Time>06:00:00Z</Time>
</Race>
<Race season="2008" round="2" url="http://en.wikipedia.org/...">
<RaceName>Malaysian Grand Prix</RaceName>
<Circuit circuitId="sepang" url="http://en.wikipedia.org/...">
<CircuitName>Sepang International Circuit</CircuitName>
<Location lat="2.76083" long="101.738">
<Locality>Kuala Lumpur</Locality>
<Country>Malaysia</Country>
</Location>
</Circuit>
<Date>2008-04-08</Date>
<Time>09:00:00Z</Time>
</Race>
.
.
.
</RaceTable>
</MRData>
JSON Example Response
{
"MRData": {
"xmlns": "http:\/\/ergast.com\/mrd\/1.0",
"series": "f1",
"limit": "30",
"offset": "0",
"total": "18",
"RaceTable": {
"season": "2008",
"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"
},
.
.
.
]
}
}
}