Vehicle actions

How to read and use vehicle actions within the c.technology platform.

Vehicle actions are points in time where a specific and significant action or event has occurred on a vehicle. This may range from rather mundane actions such as “ignition on” or “engine start” to more complex actions such as “filling in a checklist”, “leaving the home location”, or “starting a trip”.

Action structure

A vehicle action is structured as follows:

{
    "id": "vact_01k51vkrmwenprvcz87vs80z4c",  // Unique vehicle action ID in TypeID format.
    "vehicle_id": "veh_01jnk61e5pf6zs5ag6483xqe43",  // The vehicle the action is associated with.
    "user_id": null,
    "trip_id": null,  // The trip the action is associated with, if any.
    "timestamp": "2025-09-13T15:37:57.785Z",  // Time the action occurred.
    "type": "IGNITION_ON",  // The type of action, see list below for common types.
    "data": {  // Additional data associated with the action, varies by action type.
        "external_voltage": 13117
    },
    "message": "Demo Boat 1 had its ignition turned on."  // A human-readable message describing the action.
}