Fault Code Event - Terminal

{
  "protocol": "j1939",
  "id": "fc_evt_01D8ZQFGHVJ858NBF2Q7DV9MNC",
  "provider": "geotab",
  "vehicle": "vcl_01D8ZQFGHVJ858NBF2Q7DV9MNC",
  "status": "open",
  "code": "P0087",
  "observedAt": "2021-01-06T03:24:53.000Z",
  "obdii": {
    "code": "P0087",
    "description": "Fuel Rail/System Pressure - Too Low Bank 1"
  },
  "metadata": {
    "addedAt": "2023-11-07T05:31:56Z",
    "modifiedAt": "2023-11-07T05:31:56Z"
  },
  "description": "Fuel Rail/System Pressure - Too Low Bank 1",
  "milStatus": "on",
  "j1939": {
    "fmi": 9,
    "spn": 3031,
    "fmiDescription": "Voltage Below Normal",
    "spnDescription": "System Diagnostic Code #1",
    "occurrenceCount": 15,
    "sourceAddress": 256
  },
  "raw": []
}

FaultCodeEventObdii
FaultCodeEventJ1939

protocol

enum<string>

required

The diagnostic protocol used

Available options:

j1939,

obdii

Allowed value: "obdii"

string<ulid>

required

Example:

"fc_evt_01D8ZQFGHVJ858NBF2Q7DV9MNC"

provider

string

required

Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under provider details.

Example:

"geotab"

vehicle

required

Vehicle associated with the fault

Example:

"vcl_01D8ZQFGHVJ858NBF2Q7DV9MNC"

status

enum<string>

required

The status of the fault code at the time of the event. Some providers do not report closed statuses.

Available options:

open,

pending,

closed

code

string

required

The fault code identifier. For OBD-II systems: alphanumeric DTC codes (P0087, U0046, C0123, B1234). For J1939 systems: SPN-FMI format (SPN3031-FMI9) or derived codes from SPN/FMI combinations.

Example:

"P0087"

observedAt

string<date-time>

required

The time the fault code was observed

Example:

"2021-01-06T03:24:53.000Z"

obdii

object

required

OBD-II Diagnostic Trouble Code information for light/medium duty vehicles. Contains standardized alphanumeric codes like P0087, U0046, C0123, B1234.

Show child attributes

metadata

EntityMetadata · object

required

Internal metadata about the record.

Show child attributes

description

string

Human-readable description of the fault

Example:

"Fuel Rail/System Pressure - Too Low Bank 1"

milStatus

enum<string>

The Malfunction Indicator Lamp (MIL) status of the vehicle at the time the fault code was observed

Available options:

on,

off

j1939

object

J1939 fault code information for heavy-duty vehicles. FMI (Failure Mode Identifier) indicates the specific nature of the fault (0-31 numeric codes).

Show child attributes

raw

RawData · object[]

Show child attributes

Example:

[]

Vehicle Utilization HOS Log

⌘I

Common Models