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