Circuit Information

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

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

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

http://ergast.com/api/f1/circuits/monza

Circuit lists can be refined by adding one or more of the following criteria:

/constructors/<constructorId>
/drivers/<driverId>
/grid/<position>
/results/<position>
/fastest/<rank>
/status/<statusId>

For example, to list all circuits at which a specific driver has driven for a particular constructor:

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

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="17">
    <CircuitTable driverId="alonso" constructorId="mclaren">
        <Circuit circuitId="albert_park" url="http://en.wikipedia.org/wiki/Melbourne_Gr...">
            <CircuitName>Albert Park Grand Prix Circuit</CircuitName>
            <Location lat="-37.8497" long="144.968">
                <Locality>Melbourne</Locality>
                <Country>Australia</Country>
            </Location>
        </Circuit>
        <Circuit circuitId="bahrain" url="http://en.wikipedia.org/wiki/Bahrain_Internat...">
            <CircuitName>Bahrain International Circuit</CircuitName>
            <Location lat="26.0325" long="50.5106">
                <Locality>Sakhir</Locality>
                <Country>Bahrain</Country>
            </Location>
        </Circuit>
        <Circuit circuitId="catalunya" url="http://en.wikipedia.org/wiki/Circuit_de_Cat...">
            <CircuitName>Circuit de Catalunya</CircuitName>
            <Location lat="41.57" long="2.26111">
                <Locality>Montmeló</Locality>
                <Country>Spain</Country>
            </Location>
        </Circuit>
            .
            .
            .
    </CircuitTable>
</MRData>

JSON Example Response

{
  "MRData": {
    "xmlns": "http://ergast.com/mrd/1.0",
    "series": "f1",
    "limit": "30",
    "offset": "0",
    "total": "17",
    "CircuitTable": {
      "constructorId": "mclaren",
      "driverId": "alonso",
      "Circuits": [
        {
          "circuitId": "albert_park",
          "url": "http://en.wikipedia.org/wiki/Melbourne_Grand_Prix_Circuit",
          "circuitName": "Albert Park Grand Prix Circuit",
          "location": {
            "lat": "-37.8497",
            "long": "144.968",
            "locality": "Melbourne",
            "country": "Australia"
          }
        },
        {
          "circuitId": "bahrain",
          "url": "http://en.wikipedia.org/wiki/Bahrain_International_Circuit",
          "circuitName": "Bahrain International Circuit",
          "Location": {
            "lat": "26.0325",
            "long": "50.5106",
            "locality": "Sakhir",
            "country": "Bahrain"
          }
        },
        {
          "circuitId": "catalunya",
          "url": "http://en.wikipedia.org/wiki/Circuit_de_Catalunya",
          "circuitName": "Circuit de Catalunya",
          "Location": {
            "lat": "41.57",
            "long": "2.26111",
            "locality": "Montmeló",
            "country": "Spain"
          }
        },
        .
        .
        .
      ]
    }
  }
}

Back to documentation index