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

FieldDescription
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

Did this page help you?