GET
/
v2.0
/
vehicles
/
{id}
/
diagnostics
/
system_status
curl "https://api.smartcar.com/v2.0/vehicles/{id}/diagnostics/system_status" \\
    -H "Authorization: Bearer {token}" \\
    -X "GET"
{
      "systems": [
          {
              // System ID from Smartcar unified system definition list
              "systemId": "SYSTEM_TPMS",
              "status": "ALERT",
              "description": "Left rear tire sensor battery low"
          },
          {
              "systemId": "SYSTEM_AIRBAG",
              "status": "OK",
              "description": null
          },
          {
              "systemId": "SYSTEM_MIL",
              "status": "OK",
              "description": null
          },
          ...
      ]
}
The Vehicles API v2.0 will be deprecated by Q3 of 2026. We recommend migrating to the latest version as soon as possible to ensure continued support and access to new features.

Permission

read_diagnostics
curl "https://api.smartcar.com/v2.0/vehicles/{id}/diagnostics/system_status" \\
    -H "Authorization: Bearer {token}" \\
    -X "GET"

Request

Path
id
string
required
The vehicle ID of the vehicle you are making a request to.

Response

systems
array
An overview of systems reported by the vehicle.
systemID
string
The unique identifier of a system reported by the vehicle.
status
string
The status of a vehicle, expected as “OK” or “ALERT”.
description
string | null
A plain-text description of the status, if available.
{
      "systems": [
          {
              // System ID from Smartcar unified system definition list
              "systemId": "SYSTEM_TPMS",
              "status": "ALERT",
              "description": "Left rear tire sensor battery low"
          },
          {
              "systemId": "SYSTEM_AIRBAG",
              "status": "OK",
              "description": null
          },
          {
              "systemId": "SYSTEM_MIL",
              "status": "OK",
              "description": null
          },
          ...
      ]
}