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

Comments

4 responses to “Finishing Status”

  1. Macbeth Matibe Avatar
    Macbeth Matibe

    For the status, does + number of laps mean that the driver completed the race? There is a peculiar +42 laps, does this mean they were overlapped by 42 laps but still finished the race? Which + number of laps are considered to have finished the race? Thank you!

  2. Admin Avatar
    Admin

    Hi Macbeth,
    If a driver completes the race they will have a finishing position. IIRC this is when they have completed 90% of the race distance under the current rules.
    Cheers,
    Chris

  3. Jing Avatar
    Jing

    Hi,

    In status database, where could i find the definitions for ‘collision’ and ‘accident’?
    Thank you so much!

    Cheers,
    Jing

  4. Admin Avatar
    Admin

    Hi Jing,
    The status field is an informal description using free text. There are no formal definitions or schema.
    Cheers,
    Chris

Leave a Reply

Your email address will not be published. Required fields are marked *