Low Fuel
To stay informed about critical fuel levels and helping users take timely action during a trip.
**Event Type:**LOW_FUEL
Trigger Condition
Subscription to the LOW_FUEL webhook event.
This event is activated or triggered whenever the fuel level falls below a set threshold, which is 50% of the tank capacity by default.
Example Payload
{
"inputBit7": 0,
"partialUpdate": false,
"inputBit4": 0,
"voiceCallActive": 0,
"inputBit3": 0,
"pidValueShort": null,
"inputBit6": 0,
"inputBit5": 0,
"type": "OBD_EVENT_MESSAGE",
"deviceId": "e26ee1cb-2d00-11ec-b7b6-ad84c633e3fa",
"networkService": 0,
"commStateConnected": 0,
"messageType": "LOW_FUEL",
"messageIndex": "129012139",
"dimentionFix": 0,
"lastKnownLon": -116.9380601,
"inputBit0": 0,
"inputBit2": 0,
"id": "1c0048aa-7301-4eed-96cc-2051d38addcc",
"state": null,
"inputBit1": 0,
"commStatusAvaliable": 0,
"locality": null,
"eventIndex": 0,
"eventType": "LOW_ALARM",
"assetNo": "",
"fixStatusCorrected": 0,
"deviceSerial": "1070302690",
"groupName": "Default Group",
"pidValueByte": 17,
"lastKnownTime": 1662611358000,
"jmsType": "",
"vehicleName": "T147 - Ford F-250 XL 4x2 Supercab P",
"deviceTypeId": 1,
"destinationQueues": null,
"city": null,
"periodic": false,
"latitude": 32.5558192,
"unitStatus": 0,
"invalidFix": 0,
"dataService": 0,
"noOfAccums": 0,
"customerId": 14866,
"beaconMacAddress": null,
"tripNumber": 2911,
"spare": 0,
"address": null,
"roaming": 0,
"messageEventType": null,
"stateId": 0,
"dataSize": 1,
"updateTime": null,
"userId": "8a9388a9-7c3a-464c-017c-7f5aebbe3691",
"batteryPercentage": 0,
"currentState": 0,
"deviceProtocolMessageId": null,
"messageEventTypeId": 0,
"zipCode": null,
"country": null,
"deviceAssociatedVIN": "1FT7X2A61MEE09674",
"beaconType": null,
"groupId": "8697e2a0-1b2a-11ec-8d28-ff275c0e4f89",
"eventCount": 1,
"pid": 47,
"vendorTypeId": 1,
"firmwareVersion": null,
"fixStatuslastKnown": 0,
"fixStatusHistoric": 0,
"longitude": -116.9380601,
"satellites": null,
"locationTime": 1662611358000,
"odometer": 33368,
"offset": -420,
"dataType": 0,
"virtualTripEnd": false,
"imei_meid": "352602114341396",
"insideHOO": true,
"timeOfFix": null,
"sensorNames": null,
"tripPolyline": null,
"lastKnownLat": 32.5558192,
"fixQuality": 0,
"unitStatusBit0": 0,
"unitStatusBit2": 0,
"unitStatusBit1": 0,
"unitStatusBit3": 0,
"storedLocation": false,
"protocolVersionIdChange": false,
"accumesList": null,
"accumulators": null,
"fixStatusPredict": 0,
"network3G": 0,
"lastKnownAddress": null,
"privacyModeEnable": false,
"fixStatus": 0,
"vehicleId": "e26ee1ca-2d00-11ec-b7b6-2db80493465f",
"pidValueInt": null,
"lastKnownFixQuality": 0,
"pidValueFloat": null,
"userName": "1070302690",
"tripState": "ACTIVE",
"messageTypeId": 7,
"obdSpeed": null,
"location": {
"latitude": 32.5558192,
"longitude": -116.9380601
},
"commonState": 0,
"carrierId": null,
"pidValueString": null
}
Reference
Field | Description |
---|---|
type | Type of Event - Message Event
Example: |
deviceId | The unique ID of the Device
Example: |
networkService | Indicates the status of the network service,
Example: |
messageType | Type of message
Example: |
messageIndex | Unique index or identifier of the event message |
lastKnownLon | Last known longitude in degrees
Example: |
id | The unique reference ID for the given event in the system
Example: |
eventIndex | Index of the event in sequence
Example: |
assetNo | The Asset Id associated with the device, can be empty
Example: |
eventType | Type of Event
Example: |
deviceSerial | Serial Number of the Device associated with vehicle
Example: |
groupName | Name of the Group the device/vehicle is associated to
Example: |
lastKnownTime | Last known time in milliseconds
Example: |
vehicleName | Name of the vehicle
Example: |
deviceTypeId | Type identifier for device, 1-Datalogger
Example: |
city | Name of the City
Example: |
customerId | The unique Azuga ID of the Customer
Example: |
tripNumber | Represents a unique identifier assigned to a specific trip, allowing the system to track and reference that particular journey or route
Example: |
stateId | Refers to the vehicle ignition state or movement status, 0-Ignition Off and 1-Ignition On
Example: |
updateTime | Event Update Time in milliseconds.
Example: |
batteryPercentage | Percentage of Battery at time of event in %
Example: |
messageEventTypeId | Type of message event generated
Example: |
protocolVersionIdChange | Boolean flag that indicates whether the communication protocol version has changed since the last message (true = changed).
Example: |
privacyModeEnable | Indicates whether privacy mode is enabled on the device
Example: |
vehicleId | Unique ID of the vehicle
Example: |
tripState | Represents the current status of a vehicle's trip, indicating whether the trip is active, completed, or in another state.
Example: |
messageTypeId | Type identifier for message
Example: |
location | Current location object of the vehicle |
latitude | Latitude co-ordinate value in degrees
Example: |
longitude | Longitude co-ordinate value in degrees
Example: |
carrierId | Carrier/Operator the wireless modem is currently using |
address | Address of vehicle when event triggered
Example: |
roaming | Indicates whether the device was roaming on a different mobile network.
Example: |
userId | Unique Azuga generated ID of the user in UUID format |
zipCode | Zip Code Details
Example: |
country | Country Name
Example: |
deviceAssociatedVIN | Vehicle Identification Number associated to a device
Example: |
groupId | Unique identifier for the the group
Example: |
vendorTypeId | Type identifier for vendor
Example: |
firmwareversion | Firmware version details
Example: |
locationTime | Timestamp of location data
Example: |
odometer | Odometer reading
Example: |
offset | Offset value
Example: |
virtualTripEnd | Indicates if virtual trip ended
Example: |
imei_meid | Imei ID
Example: |
insideHOO | Indicates if inside hours of operation
Example: |
lastKnownLat | Last known latitude in degrees |
storedLocation | Indicates whether the device has stored a location
Example: |
userName | Username
Example: |
tripState | Current trip state
Example: |
messageTypeId | Type identifier for message
Example: |
obdSpeed | OBD device Speed in Kilometers per Hour
Example: |
carrierId | Carrier/Operator the wireless modem is currently using |
pid | Parameter ID (PID) used to identify specific OBD data like speed, fuel, etc.
Example: |
pidValueShort | PID value represented as a short data type (used for vehicle diagnostics).
Example: |
pidValueByte | PID value represented in byte format, typically used for simple status flags or readings.
Example: |
periodic | Indicates whether the message is part of a periodic update (e.g., routine transmission).
Example: |
dataSize | Size of the data payload in bytes for the given message.
Example: |
eventCount | Number of events logged or detected during this message.
Example: |
dataType | Type of data being reported (e.g., raw, processed, diagnostic).
Example: |
pidValueInt" | PID value represented as an integer, typically used for numerical diagnostic values. Example: null |
pidValueString | PID value represented as a string, often used for descriptive or alphanumeric data. Example: null |
Updated 5 days ago