Standings

To list the driver or constructor standings after a specific race use the following URLs with the required year and round number:

http://ergast.com/api/f1/2008/5/driverStandings
http://ergast.com/api/f1/2008/5/constructorStandings

To list the driver or constructor standings at the end of a specific season use the following URLs with the required year. If the season hasn’t ended you will get the current standings:

http://ergast.com/api/f1/2008/driverStandings
http://ergast.com/api/f1/2008/constructorStandings

Current standings can always be obtained using the following static URLs:

http://ergast.com/api/f1/current/driverStandings
http://ergast.com/api/f1/current/constructorStandings

All winners of the driver or constructor championships can be obtained using:

http://ergast.com/api/f1/driverStandings/1
http://ergast.com/api/f1/constructorStandings/1

Driver standings can be refined by specifying the driver. For example:

http://ergast.com/api/f1/drivers/alonso/driverStandings

Constructor standings refined by specifying the constructor. For example:

http://ergast.com/api/f1/constructors/renault/constructorStandings

No other qualifiers are permitted in standings queries.

XML Example Response

<MRData xmlns="http://ergast.com/mrd/1.0" series="f1" limit="30" offset="0" total="22">
    <StandingsTable season="2008">
        <StandingsList season="2008" round="18">
            <DriverStanding position="1" points="98" wins="5">
                <Driver driverId="hamilton" dob="1985-01-07" url="http://...">
                    <GivenName>Lewis</GivenName>
                    <FamilyName>Hamilton</FamilyName>
                    <DateOfBirth>1985-01-07</DateOfBirth>
                    <Nationality>British</Nationality>
                </Driver>
                <Constructor constructorId="mclaren" url="http://...">
                    <Name>McLaren</Name>
                    <Nationality>British</Nationality>
                </Constructor>
            </DriverStanding>
            <DriverStanding position="2" points="97" wins="6">
                <Driver driverId="massa" dob="1981-04-25" url="http://...">
                    <GivenName>Felipe</GivenName>
                    <FamilyName>Massa</FamilyName>
                    <DateOfBirth>1981-04-25</DateOfBirth>
                    <Nationality>Brazilian</Nationality>
                </Driver>
                <Constructor constructorId="ferrari" url="http://...">
                    <Name>Ferrari</Name>
                    <Nationality>Italian</Nationality>
                </Constructor>
            </DriverStanding>
                .
                .
                .
        </StandingsList>
    </StandingsTable>
</MRData>

JSON Example Response

{
  "MRData": {
    "xmlns": "http://ergast.com/mrd/1.0",
    "series": "f1",
    "limit": "30",
    "offset": "0",
    "total": "22",
    "StandingsTable": [
      "season": "2008",
      "StandingsLists": [
        {
          "season": "2008",
          "round": "18",
          "DriverStandings": [
            {
              "position": "1",
              "points": "98",
              "wins": "5",
              "Driver": {
                "driverId": "hamilton",
                "url": "http://en.wikipedia.org/wiki/Lewis_Hamilton",
                "givenName": "Lewis",
                "familyName": "Hamilton",
                "dateOfBirth": "1985-01-07",
                "nationality": "British"
              }
              "Constructors": [
                {
                  "constructorId": "mclaren",
                  "url": "http://en.wikipedia.org/wiki/McLaren",
                  "name": "McLaren",
                  "nationality": "British"
                }
              ]
            },
            .
            .
            .
          ]
        }
      ]
    }
  }
}

Back to documentation index