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.

The value of the position attribute in the DriverStanding or ConstructorStanding element is always an integer. The value of the positionText attribute is either an integer, ā€œDā€ (disqualified) or ā€œEā€ (excluded).

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" positionText="1" points="98" wins="5">
                <Driver driverId="hamilton" code="HAM" url="http://...">
                    <PermanentNumber>44</PermanentNumber>
                    <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" positionText="2" points="97" wins="6">
                <Driver driverId="massa" code="MAS" url="http://...">
                    <PermanentNumber>19</PermanentNumber>
                    <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",
              "positionText": "1",
              "points": "98",
              "wins": "5",
              "Driver": {
                "driverId": "hamilton",
                "permanentNumber": "44",
                "code": "HAM",
                "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