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