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

FieldDescription
type
String
Type of Event - Message Event
Example: "OBD_EVENT_MESSAGE"
deviceId
String, UUID
The unique ID of the Device
Example: "3f14843e-14c7-11ed-9449-43d7d49f480d"
networkService
Integer
Indicates the status of the network service,
Example: 0
messageType
String
Type of message
Example: "LOW_FUEL
messageIndex
String
Unique index or identifier of the event message
Example: "2267"
lastKnownLon
Double
Last known longitude in degrees
Example: 77.611127
id
String, UUID
The unique reference ID for the given event in the system
Example: "1c00d95d-3301-4272-b9f6-72a0224bbf9e"
eventIndex
Integer
Index of the event in sequence
Example: 115
assetNo
String
The Asset Id associated with the device, can be empty
Example: ""
eventType
String
Type of Event
Example: LOW_ALARAM
deviceSerial
String
Serial Number of the Device associated with vehicle
Example: "3339076777"
groupName
String
Name of the Group the device/vehicle is associated to
Example: "Default Group"
lastKnownTime
Time Stamp
Last known time in milliseconds
Example: 1662630015000
vehicleName
String
Name of the vehicle
Example: "3339076777"
deviceTypeId
Integer
Type identifier for device, 1-Datalogger
Example: 1
city
String
Name of the City
Example:san jose
customerId
Integer
The unique Azuga ID of the Customer
Example: 15047
tripNumber
Integer
Represents a unique identifier assigned to a specific trip, allowing the system to track and reference that particular journey or route
Example: 5456
stateId
Integer
Refers to the vehicle ignition state or movement status, 0-Ignition Off and 1-Ignition On
Example: 0
updateTime
TimeStamp
Event Update Time in milliseconds.
Example: 1663916021
batteryPercentage
Double
Percentage of Battery at time of event in %
Example: 20
messageEventTypeId
Integer
Type of message event generated
Example: 0
protocolVersionIdChange
boolean
Boolean flag that indicates whether the communication protocol version has changed since the last message (true = changed).
Example: false
privacyModeEnable
Boolean
Indicates whether privacy mode is enabled on the device
Example: false
vehicleId
String, UUID
Unique ID of the vehicle
Example: "3f14843d-14c7-11ed-9449-2f5611afcf3f"
tripState
String
Represents the current status of a vehicle's trip, indicating whether the trip is active, completed, or in another state.
Example: "ACTIVE"
messageTypeId
Integer
Type identifier for message
Example: 0
location
Location {
latitude: 34.12
longitude: -82.14
}
Current location object of the vehicle
latitude
Double
Latitude co-ordinate value in degrees
Example: 34.12
longitude
Double
Longitude co-ordinate value in degrees
Example: -82.34
carrierId
Integer
Carrier/Operator the wireless modem is currently using
Example:410
address
String
Address of vehicle when event triggered
Example: 115 Evergreen Rd, Sanatoga, PA 19464, USA
roaming
Integer
Indicates whether the device was roaming on a different mobile network.
Example: 0 = not roaming; 1 = roaming.
userId
String, UUID
Unique Azuga generated ID of the user in UUID format
Example: "8a938091-8268-7d94-0182-6e50994400ba"
zipCode
Integer
Zip Code Details
Example: "30060"
country
String
Country Name
Example: "US"
deviceAssociatedVIN
String
Vehicle Identification Number associated to a device
Example: W1W40CHY0MT044280
groupId
String,UUID
Unique identifier for the the group
Example: "c337220c-8672-11e2-9b71-55cae3166848"
vendorTypeId
Integer
Type identifier for vendor
Example: 1
firmwareversion
String
Firmware version details
Example: "34D0019F1D"
locationTime
Time Stamp
Timestamp of location data
Example: 1662630309000
odometer
Integer
Odometer reading
Example: 51325
offset
Integer
Offset value
Example: -240
virtualTripEnd
Boolean
Indicates if virtual trip ended
Example: false
imei_meid
String
Imei ID
Example: 2342432423423
insideHOO
Boolean
Indicates if inside hours of operation
Example: true
lastKnownLat
Double
Last known latitude in degrees
Example: 17.691376
storedLocation
boolean
Indicates whether the device has stored a location
Example: false
userName
String
Username
Example: "3339076777"
tripState
String
Current trip state
Example: "ACTIVE"
messageTypeId
Integer
Type identifier for message
Example: 0
obdSpeed
Integer
OBD device Speed in Kilometers per Hour
Example:0
carrierId
Integer
Carrier/Operator the wireless modem is currently using
410
pid
Integer
Parameter ID (PID) used to identify specific OBD data like speed, fuel, etc.
Example: 47
pidValueShortPID value represented as a short data type (used for vehicle diagnostics).
Example: null
pidValueByte
Integer
PID value represented in byte format, typically used for simple status flags or readings.
Example: 7
periodic
Boolean
Indicates whether the message is part of a periodic update (e.g., routine transmission).
Example: true
dataSize
Integer
Size of the data payload in bytes for the given message.
Example: 1
eventCount
Integer
Number of events logged or detected during this message.
Example: 1
dataType
Integer
Type of data being reported (e.g., raw, processed, diagnostic).
Example: 0
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