Race Schedule

To obtain the schedule of races for a specific season use the following URL with the required year:

http://ergast.com/api/f1/2012

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

Back to documentation index