Season List

To list the seasons currently supported by the API use the following URL:

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

Season lists can be refined by adding one or more of the following criteria:

/circuits/<circuitId>
/constructors/<constructorId>
/drivers/<driverId>
/grid/<position>
/results/<position>
/fastest/<rank>
/status/<statusId>

For example, to list all seasons where a specific driver has driven for a particular constructor:

http://ergast.com/api/f1/drivers/alonso/constructors/renault/seasons

Alternatively, to list the seasons where a specific driver or constructor has achieved a particular final position in the championship:

http://ergast.com/api/f1/drivers/alonso/driverStandings/1/seasons
http://ergast.com/api/f1/constructors/renault/constructorStandings/1/seasons

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="5">
    <SeasonTable driverId="alonso" constructorId="renault">
        <Season url="http://en.wikipedia.org/wiki/F1_2003">2003</Season>
        <Season url="http://en.wikipedia.org/wiki/F1_2004">2004</Season>
        <Season url="http://en.wikipedia.org/wiki/F1_2005">2005</Season>
        <Season url="http://en.wikipedia.org/wiki/F1_2006">2006</Season>
        <Season url="http://en.wikipedia.org/wiki/F1_2008">2008</Season>
    </SeasonTable>
</MRData>

JSON Example Response

{
  "MRData": {
    "xmlns": "http:\/\/ergast.com\/mrd\/1.0",
    "series": "f1",
    "limit": "30",
    "offset": "0",
    "total": "5",
    "SeasonTable": {
      "constructorId": "renault",
      "driverId": "alonso",
      "Seasons": [
        {"season": "2003", "url": "http:\/\/en.wikipedia.org\/wiki\/F1_2003"},
        {"season": "2004", "url": "http:\/\/en.wikipedia.org\/wiki\/F1_2004"},
        {"season": "2005", "url": "http:\/\/en.wikipedia.org\/wiki\/F1_2005"},
        {"season": "2006", "url": "http:\/\/en.wikipedia.org\/wiki\/F1_2006"},
        {"season": "2008", "url": "http:\/\/en.wikipedia.org\/wiki\/F1_2008"}
      ]
    }
  }
}

Back to documentation index