Accident Detection

The ACCIDENT_DETECTION event is triggered when the system detects a potential or confirmed vehicle collision based on sensor data received from the device. This event provides detailed crash information, including location, timestamp, device ID, confidence level, and vehicle details, enabling real-time accident monitoring and faster incident response.

Event Name: ACCIDENT_DETECTION

Enablement Package: Collision Detection


Trigger Condition

The ACCIDENT_DETECTION webhook event is triggered when a collision is detected by the device.
The following conditions must be met for the event to be published:

  • Collision Detection feature must be enabled for the account or device.
  • The webhook must be subscribed to the ACCIDENT_DETECTION event.
  • When crash data is detected and transmitted from the device, the system publishes the event payload to the configured webhook URL.

Example Payload

{
  "inputBit7": 0,
  "partialUpdate": false,
  "inputBit4": 0,
  "voiceCallActive": 0,
  "inputBit3": 0,
  "inputBit6": 0,
  "groupId": "559d6f4c-11bf-11ed-8895-27b5feb885d3",
  "inputBit5": 0,
  "standStillCrash": false,
  "type": "ACCIDENT_DETECTION",
  "deviceId": "3f14843e-14c7-11ed-9449-43d7d49f480d",
  "initialSpeed": 0,
  "crash": true,
  "networkService": 0,
  "finalSpeed": 0,
  "commStateConnected": 0,
  "messageType": "ACCIDENT_DETECTION",
  "messageIndex": "0",
  "dimentionFix": 0,
  "lastKnownLon": 77.611127,
  "inputBit0": 0,
  "vendorTypeId": 1,
  "inputBit2": 0,
  "id": "1c00d95d-3301-4272-b9f6-72a0224bbf9e",
  "inputBit1": 0,
  "fixStatuslastKnown": 0,
  "fixStatusHistoric": 0,
  "commStatusAvaliable": 0,
  "locationTime": 1662630309000,
  "odometer": 0,
  "offset": 0,
  "virtualTripEnd": false,
  "eventIndex": 0,
  "assetNo": "",
  "fixStatusCorrected": 0,
  "pushPopCrash": false,
  "insideHOO": true,
  "deviceSerial": "3339076777",
  "eventAliasId": "dc5c3f84-a601-11e5-96ee-22000ac501ss",
  "groupName": "Default Group",
  "spikeOnlyCrash": false,
  "bumpCrash": false,
  "lastKnownTime": 1662630015000,
  "jmsType": "",
  "lastKnownLat": 17.691376,
  "fixQuality": 0,
  "unitStatusBit0": 0,
  "vehicleName": "3339076777",
  "unitStatusBit2": 0,
  "deviceTypeId": 1,
  "unitStatusBit1": 0,
  "unitStatusBit3": 0,
  "storedLocation": false,
  "protocolVersionIdChange": true,
  "unitStatus": 0,
  "fixStatusPredict": 0,
  "invalidFix": 0,
  "dataService": 0,
  "network3G": 0,
  "noOfAccums": 0,
  "privacyModeEnable": false,
  "customerId": 15047,
  "fixStatus": 0,
  "vehicleId": "3f14843d-14c7-11ed-9449-2f5611afcf3f",
  "tripNumber": 0,
  "lastKnownFixQuality": 0,
  "spare": 0,
  "roaming": 0,
  "stateId": 0,
  "confidence": "max 75",
  "userName": "3339076777",
  "userId": "8a938091-8268-7d94-0182-6e50994400ba",
  "tripState": "ACTIVE",
  "messageTypeId": 0,
  "location": {
    "latitude": 34.73975,
    "longitude": -82.379671
  },
  "batteryPercentage": 0,
  "commonState": 0,
  "currentState": 0,
  "potCrash": true,
  "messageEventTypeId": 0
}

Reference

Field

Description

groupId*
String, UUID

Group to which the vehicle belongs. Example: "559d6f4c-11bf-11ed-8895-27b5feb885d3"

type**
String

Identifies the webhook event type. Example: "ACCIDENT_DETECTION"

deviceId*
String, UUID

Unique ID of the device that reported the event. Example: "3f14843e-14c7-11ed-9449-43d7d49f480d"

messageType*
String

Type of message.
Example: "ACCIDENT_DETECTION"

lastKnownLon*
Double

Last known longitude before crash. Example: 77.611127

vendorTypeId*
Integer

Vendor type identifier. Example: 1

id*
String, UUID

Unique identifier for the event. Example: "1c00d95d-3301-4272-b9f6-72a0224bbf9e"

locationTime*
Time Stamp

Event timestamp in epoch (milliseconds). Example: 1662630309000

deviceSerial*
String

Device serial number.
Example: "3339076777"

eventAliasId*
String, UUID

Unique event alias reference. Example: "dc5c3f84-a601-11e5-96ee-22000ac501ss"

groupName*
String

Name of the group. Example: "Default Group"

lastKnownTime*
Time Stamp

Last known timestamp. Example: 166263001500

lastKnownLat*
Double

Last known latitude. Example: 17.691376

vehicleName*
String

Vehicle display name or serial. Example: "3339076777"

customerId*
Integer

Unique identifier for customer.
Example: 15047

vehicleId*
String, UUID

Unique ID of the vehicle. Example: "3f14843d-14c7-11ed-9449-2f5611afcf3f"

confidence*
String

Confidence level of crash detection. Example: "max 75"

userName*
String

Associated driver username. Example: "3339076777"

userId*
String, UUID

Unique identifier for the user. Example: "8a938091-8268-7d94-0182-6e50994400ba"

tripState*
String

Trip state when crash detected. Example: "ACTIVE"

latitude*
Double

Latitude of the crash location. Example: 34.12

longitude*
Double

Longitude of the crash location. Example: -82.34

batteryPercentage*
Double

Current battery level of device. Example: 20