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
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

pidValueShort

PID 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