Fuel Decrease Event

Notifies when a fuel drop is detected

Event Type: FUEL_DECREASE

Trigger Condition

To ensure you're always in the loop about fuel levels, subscribing to the FUEL_DECREASE webhook event is a must. This event kicks in right when a trip begins. Additionally, it will notify you mid-trip if the fuel tank suddenly drops by 30% or more.

Example Payload

{
"inputBit7": 0,
"partialUpdate": false,
"inputBit4": 0,
"voiceCallActive": 0,
"inputBit3": 0,
"inputBit6": 0,
"inputBit5": 0,
"type": "FUEL_EVENT_MESSAGE",
"deviceId": "a800913e-f94d-11ec-8b36-1309e579cfea",
"networkService": 0,
"commStateConnected": 0,
"messageType": "FUEL_DECREASE",
"messageIndex": "128448715",
"dimentionFix": 0,
"lastKnownLon": -86.7038829,
"cumulativeFuelConsumed": 340.923,
"inputBit0": 0,
"inputBit2": 0,
"id": "1c00e8ae-9101-470e-b781-2a619e8aa1e5",
"state": null,
"inputBit1": 0,
"commStatusAvaliable": 0,
"locality": null,
"eventIndex": 0,
"assetNo": "",
"fixStatusCorrected": 0,
"deviceSerial": "1112504564",
"groupName": "Nashville",
"fuelEventType": 2,
"lastKnownTime": 1662598777000,
"jmsType": "",
"vehicleName": "NSH_004-917263",
"deviceTypeId": 1,
"destinationQueues": null,
"city": null,
"latitude": 36.3075667,
"unitStatus": 0,
"invalidFix": 0,
"dataService": 0,
"noOfAccums": 0,
"customerId": 14924,
"beaconMacAddress": null,
"tripNumber": 165,
"spare": 0,
"address": null,
"roaming": 0,
"messageEventType": null,
"stateId": 0,
"updateTime": null,
"userId": "8a9388a9-81ce-1695-0182-3af23d4b4e28",
"batteryPercentage": 0,
"currentState": 0,
"deviceProtocolMessageId": null,
"newFuelLevel": 53,
"messageEventTypeId": 0,
"zipCode": null,
"country": null,
"deviceAssociatedVIN": "1FTBW3X84LKA91870",
"beaconType": null,
"groupId": "cded3f1e-e2b8-11ec-a359-6b5ab7a8d6a8",
"vendorTypeId": 1,
"firmwareVersion": null,
"fixStatuslastKnown": 0,
"fixStatusHistoric": 0,
"longitude": -86.7038829,
"satellites": null,
"locationTime": 1662598777000,
"odometer": 66599,
"offset": -300,
"virtualTripEnd": false,
"imei_meid": "352602116841310",
"insideHOO": true,
"timeOfFix": null,
"sensorNames": null,
"tripPolyline": null,
"lastKnownLat": 36.3075667,
"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,
"prevFuelLevel": 98,
"vehicleId": "a800913d-f94d-11ec-8b36-0b9d11973322",
"lastKnownFixQuality": 0,
"userName": "John Burke",
"tripState": "ACTIVE",
"messageTypeId": 19,
"obdSpeed": null,
"location": {
"latitude": 36.3075667,
"longitude": -86.7038829
},
"commonState": 0,
"carrierId": null
}

Reference

Field

Description

type String

Type of Event - Message Event
Example: FUEL_EVENT_MESSAGE

deviceId
String,UUID

The unique ID of the Device
Example: a800913e-f94d-11ec-8b36-1309e579cfea

networkService
Integer

Indicates the status of the network service,
Example: 0

messageType
String

Type of Message
Example: FUEL_DECREASE

messageIndex
Integer

Unique index or identifier of the event message
Example: 128448715

lastKnownLon
Double

Last known longitude in degrees
Example: -86.7039

  • *cumulativeFuelConsumed**Double

Total amount of fuel consumed by the vehicle since tracking began, measured in gallons
Example: 340.923

id
String,UUID

The unique reference ID for the given event in the system
Example: 1c00e8ae-9101-470e-b781-2a619e8aa1e5

eventIndex

Example: 0

assetNo
String

The Asset Id associated with the device, can be empty.
Example: TRL201

deviceSerial
Integer

Serial Number of the Device associated with vehicle
Example: 1112504564

groupName
String

Name of the Group the device/vehicle is associated to
Example: Nashville

fuelEventType
Integer

Indicates the type of fuel event.
Example: 1 for increase, 2 for decrease.

lastKnownTime
TimeStamp

Last known time in milliseconds
Example: 1662598777000

vehicleName
String

Name of the Vehicle
Example: NSH_004-917263

deviceTypeId
Integer

Type identifier for device, 1-Datalogger
Example: 1

dataService
Integer

Indicates whether the device had active mobile data service at the time of the event. Value 0 typically means no data service.
Example: 0

customerId
Integer

The unique Azuga ID of the Customer
Example: 14924

tripNumber
Integer

Represents a unique identifier assigned to a specific trip, allowing the system to track and reference that particular journey or route
Example: 165

roaming
Integer

Indicates whether the device was roaming on a different mobile network.
Example: 0 = not roaming; 1 = roaming.

stateId
Integer

Refers to the vehicle ignition state or movement status, 0-Ignition Off and 1-Ignition On
Example: 0

userId
String,UUID

Unique Azuga generated ID of the user in UUID format
Example: 8a9388a9-81ce-1695-0182-3af23d4b4e28

batteryPercentage
Double

Percentage of Battery at time of event in %
Example: 0

newFuelLevel
Integer

The current or most recently measured fuel level at the time this event was triggered in percentage %
Example: 53

deviceAssociatedVIN
String

Vehicle Identification Number associated to a device
Example: 1FTBW3X84LKA91870

groupId
String,UUID

Unique Azuga generated ID of the group in UUID format
Example: cded3f1e-e2b8-11ec-a359-6b5ab7a8d6a8

vendorTypeId
Integer

Type identifier for vendor
Example: 1

locationTime
Integer

Time of event Occurrence in ms
Example: 1662598777000

odometer
Integer

Odometer Reading of the Vehicle in kms
Example: 66599

offset
Integer

device timezone offset
Example: -300

virtualTripEnd
Boolean

Indicates whether the trip has ended virtually, meaning the system marks the end of the trip without the vehicle physically stopping.
Example: false

imei_meid
Integer

imei ID
Example: 352602116841310

insideHOO
Boolean

Indicates if inside hours of operation
Example: true

lastKnownLat
Double

Last known latitude in degrees
Example: 36.3076

storedLocation
Boolean

Indicates whether the device has stored a location
Example: false

  • *protocolVersionIdChange**Boolean

Boolean flag that indicates whether the communication protocol version has changed since the last message (true = changed).
Example: false

network3G
Integer

Status of 3G Network
Example: 0

privacyModeEnable
Boolean

Indicates whether privacy mode is enabled on the device
Example: false

prevFuelLevel
Integer

The previously recorded fuel level before the current reading in percentage %
Example: 98

vehicleId
String,UUID

The unique ID of the Vehicle
Example: a800913d-f94d-11ec-8b36-0b9d11973322

userName
String

Name of the User associated to the device/vehicle
Example: John Burke

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

obdSpeed
Integer

OBD device Speed in Kilometers per Hour
Example: 10

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