Finishing Status

To obtain a list of all finishing status codes used by the API use the following URL:

http://ergast.com/api/f1/status

The list can be restricted to those relevant to a specific season or round. For example:

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

Finishing status can also be listed using 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 the finishing status for a specific driver in a particular season:

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

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="5">
    <StatusTable season="2008" driverId="alonso">
        <Status statusId="1" count="13">Finished</Status>
        <Status statusId="4" count="1">Collision</Status>
        <Status statusId="5" count="1">Engine</Status>
        <Status statusId="11" count="2">+1 Lap</Status>
        <Status statusId="20" count="1">Spun off</Status>
    </StatusTable>
</MRData>

JSON Example Response

{
  "MRData": {
    "xmlns": "http://ergast.com/mrd/1.0",
    "series": "f1",
    "limit": "30",
    "offset": "0",
    "total": "5",
    "StatusTable": {
      "season": "2008",
      "driverId": "alonso",
      "Status": [
        {"statusId": "1", "count": "13", "status": "Finished"},
        {"statusId": "4", "count": "1", "status": "Collision"},
        {"statusId": "5", "count": "1", "status": "Engine"},
        {"statusId": "11", "count": "2", "status": "+1 Lap"},
        {"statusId": "20", "count": "1", "status": "Spun off"}
      ]
    }
  }
}

Back to documentation index