Driver Information

To obtain a list of all drivers within a series, year or round use the following URLs:

http://ergast.com/api/f1/drivers
http://ergast.com/api/f1/2010/drivers
http://ergast.com/api/f1/2010/2/drivers

Each driver listed in the response is identified by a unique driverId which is used to identify the driver throughout the API. To obtain information about a particular driver append the driverId e.g:

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

Driver 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 drivers who have driven for a specific constructor at a particular circuit:

http://ergast.com/api/f1/constructors/mclaren/circuits/monza/drivers

Alternatively, to list the drivers who have achieved a particular final position in the championship:

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

Drivers who participated in the 2014 season onwards have a permanent driver number.

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="8">
    <DriverTable constructorId="mclaren" circuitId="monza">
        <Driver driverId="alonso" code="ALO" url="http://en.wikipedia.org/wiki/Fernando_Alonso">
            <PermanentNumber>14</PermanentNumber>

            <GivenName>Fernando</GivenName>
            <FamilyName>Alonso</FamilyName>
            <DateOfBirth>1981-07-29</DateOfBirth>
            <Nationality>Spanish</Nationality>
        </Driver>
        <Driver driverId="coulthard" code="COU" url="http://en.wikipedia.org/wiki/David_Coulthard">
            <GivenName>David</GivenName>
            <FamilyName>Coulthard</FamilyName>
            <DateOfBirth>1971-03-27</DateOfBirth>
            <Nationality>British</Nationality>
        </Driver>
        <Driver driverId="rosa" code="DLR" url="http://en.wikipedia.org/wiki/Pedro_de_la_Rosa">
            <GivenName>Pedro</GivenName>
            <FamilyName>de la Rosa</FamilyName>
            <DateOfBirth>1971-02-24</DateOfBirth>
            <Nationality>Spanish</Nationality>
        </Driver>
            .
            .
            .
    </DriverTable>
</MRData>

JSON Example Response

{
  "MRData": {
    "xmlns": "http://ergast.com/mrd/1.0",
    "series": "f1",
    "limit": "30",
    "offset": "0",
    "total": "8",
    "DriverTable": {
      "circuitId": "monza",
      "constructorId": "mclaren",
      "Drivers": [
        {
          "driverId": "alonso",
          "permanentNumber": "14",
          "code": "ALO",
          "url": "http://en.wikipedia.org/wiki/Fernando_Alonso",
          "givenName": "Fernando",
          "familyName": "Alonso",
          "dateOfBirth": "1981-07-29",
          "nationality": "Spanish"
        },
        {
          "driverId": "coulthard",
          "code": "COU",
          "url": "http://en.wikipedia.org/wiki/David_Coulthard",
          "givenName": "David",
          "familyName": "Coulthard",
          "dateOfBirth": "1971-03-27",
          "nationality": "British"
        },
        {
          "driverId": "rosa",
          "code": "DLR",
          "url": "http://en.wikipedia.org/wiki/Pedro_de_la_Rosa",
          "givenName": "Pedro",
          "familyName": "de la Rosa",
          "dateOfBirth": "1971-02-24",
          "nationality": "Spanish"
        },
        .
        .
        .
      ]
    }
  }
}

Back to documentation index