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
Schedule details before 2022 are limited to the date/time of the Grand Prix.
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="2022">
<Race season="2022" round="3" 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>2022-04-10</Date>
<Time>06:00:00Z</Time>
<FirstPractice>
<Date>2022-04-08</Date>
<Time>03:00:00Z</Time>
</FirstPractice>
<SecondPractice>
<Date>2022-04-08</Date>
<Time>06:00:00Z</Time>
</SecondPractice>
<ThirdPractice>
<Date>2022-04-09</Date>
<Time>03:00:00Z</Time>
</ThirdPractice>
<Qualifying>
<Date>2022-04-09</Date>
<Time>06:00:00Z</Time>
</Qualifying>
</Race>
.
.
.
</RaceTable>
</MRData>
JSON Example Response
{
"MRData": {
"xmlns": "http:\/\/ergast.com\/mrd\/1.0",
"series": "f1",
"limit": "30",
"offset": "0",
"total": "22",
"RaceTable": {
"season": "2022",
"Races": [
{
"season": "2022",
"round": "3",
"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": "2022-04-10",
"time": "05:00:00Z",
"FirstPractice":{
"date":"2022-04-08",
"time":"03:00:00Z"
},
"SecondPractice":{
"date":"2022-04-08",
"time":"06:00:00Z"
},
"ThirdPractice":{
"date":"2022-04-09",
"time":"03:00:00Z"
},
"Qualifying":{
"date":"2022-04-09",
"time":"06:00:00Z"
}
},
.
.
.
]
}
}
}