Constructor Information

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

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

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

http://ergast.com/api/f1/constructors/mclaren

Constructor 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 constructors a specific driver has driven for at a particular circuit:

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

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

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

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="3">
    <ConstructorTable driverId="alonso" circuitId="monza">
        <Constructor constructorId="mclaren" url="http://en.wikipedia.org/wiki/McLaren">
            <Name>McLaren</Name>
            <Nationality>British</Nationality>
        </Constructor>
        <Constructor constructorId="minardi" url="http://en.wikipedia.org/wiki/Minardi">
            <Name>Minardi</Name>
            <Nationality>Italian</Nationality>
        </Constructor>
        <Constructor constructorId="renault" url="http://en.wikipedia.org/wiki/Renault_F1">
            <Name>Renault</Name>
            <Nationality>French</Nationality>
        </Constructor>
    </ConstructorTable>
</MRData>

JSON Example Response

{
{
  "MRData": {
    "xmlns": "http://ergast.com/mrd/1.0",
    "series": "f1",
    "limit": "30",
    "offset": "0",
    "total": "3",
    "ConstructorTable": {
      "circuitId": "monza",
      "driverId": "alonso",
      "Constructors": [
        {
          "constructorId": "mclaren",
          "url": "http://en.wikipedia.org/wiki/McLaren",
          "name": "McLaren",
          "nationality": "British"
        },
        {
          "constructorId": "minardi",
          "url": "http://en.wikipedia.org/wiki/Minardi",
          "name": "Minardi",
          "nationality": "Italian"
        },
        {
          "constructorId": "renault",
          "url": "http://en.wikipedia.org/wiki/Renault_F1",
          "name": "Renault",
          "nationality": "French"
        }
      ]
    }
  }
}

Back to documentation index