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

Back to documentation index