Fuel Level Remaining (%)

Event Type: FUEL_LEVEL_EVENT

Trigger Condition

Subscription to FUEL_LEVEL_EVENT webhook is a must.
A webhook providing the current fuel level as a percentage of the tank capacity is triggered every 5mins while the vehicle is on an active trip.

Example Payload

{
  "messageType": "FUEL_LEVEL_EVENT",
  "generatedAt": 1756684774651,
  "data": {
    "messageEventType": "FUEL_LEVEL_EVENT",
    "type": "OBD_EVENT_MESSAGE",
    "messageType": "OBD_PERIODIC_MESSAGE",
    "serialNumber": "0051286028",
    "processed": true,
    "messageIndex": "287659",
    "id": "2700e3d5-f901-45d0-aeea-507c4a070fba",
    "deviceSerial": "0051286028",
    "deviceId": "88919396-ab1b-11ea-a4b9-83d3a9ba5763",
    "vehicleId": "88919395-ab1b-11ea-a4b9-fb038dce128e",
    "vehicleName": "96364",
    "groupId": "8c2fa213-1f96-11ec-aa23-df8ea57e0b32",
    "groupName": "245 - Eugene, OR",
    "customerId": 6888,
    "locationTime": 1756684769000,
    "tripNumber": 12314,
    "location": {
      "latitude": 44.0777011,
      "longitude": -123.4466061
    },
    "odometer": 185855,
    "tripState": "ACTIVE",
    "fixQuality": 0,
    "offset": -420,
    "insideHOO": true,
    "userId": "8a94c900-9528-ccf9-0195-2a9488ff1640",
    "userName": "Coltyn Cook",
    "messageTypeId": 2,
    "batteryPercentage": 0,
    "lastKnownLat": 44.0777308,
    "lastKnownLon": -123.4465964,
    "lastKnownTime": 1756684768000,
    "lastKnownFixQuality": 0,
    "partialUpdate": false,
    "imei_meid": "015169000814596",
    "deviceTypeId": 1,
    "vendorTypeId": 1,
    "latitude": 44.0777011,
    "longitude": -123.4466061,
    "stateId": 0,
    "deviceAssociatedVIN": "1N6AF0KYXMN810439",
    "dataType": 0,
    "dataSize": 1,
    "eventCount": 0,
    "fuelPercentage": 80.7843137254902,
    "periodic": true,
    "virtualTripEnd": false,
    "storedLocation": false,
    "partitionKey": "0051286028"
  }
}

Reference

Field	Description
messageEventType String	Type of Event the message represents Example: `FUEL_LEVEL_EVENT`
generatedAt String	Time when the event was generated (in milliseconds). Eg:1756684774651
type String	Type of event Example: `"OBD_EVENT_MESSAGE"`
messageType String	Type of Message Example: `OBD_PERIODIC_MESSAGE`
serialNumber Integer	Serial Number of the Device associated with vehicle Example: `"0051286028"`
processed Boolean	Indicates whether the data or event has been successfully processed by system. Example: `true`
messageIndex String	Unique index or identifier of the event message Example: `"287659"`
id String, UUID	The unique reference ID for the given event in the system Example: `"2700e3d5-f901-45d0-aeea-507c4a070fba"`
deviceSerial String	Serial Number of the Device associated with vehicle Example: `"0051286028"`
deviceId String, UUID	Unique ID of the device Example: `"88919396-ab1b-11ea-a4b9-83d3a9ba5763"`
vehicleId String, UUID	Unique ID of the vehicle Example: `"88919395-ab1b-11ea-a4b9-fb038dce128e"`
vehicleName String	Name of the vehicle Example: `"96364"`
groupId String,UUID	Unique ID of the group Example: `"8c2fa213-1f96-11ec-aa23-df8ea57e0b32"`
groupName String	Name of the Group the device/vehicle is associated to Example: `"245 - Eugene, OR"`
locationTime Time Stamp	Timestamp of location data Example: `1756684769000`
customerId Integer	The unique Azuga ID of the Customer Example: `6888`
tripNumber Integer	Represents a unique identifier assigned to a specific trip, allowing the system to track and reference that particular journey or route Example: `12314`
location Location { latitude: 44.0777011 longitude: -123.4466061 }	Current location object of the vehicle
latitude Double	Latitude co-ordinate value in degrees Example: `44.0777011`
longitude Double	Longitude co-ordinate value in degrees Example: `-123.4466061`
odometer Integer	Odometer Reading of the Vehicle in kms Example: `185855`
tripState String	Represents the current status of a vehicle's trip, indicating whether the trip is active, completed, or in another state. Example: `"ACTIVE"`
offset Integer	Offset value Example: `-420`
insideHOO Boolean	Indicates if inside hours of operation Example: `true`
userName String	Name of the User associated to the device/vehicle Example: `"Coltyn Cook"`
userId String,UUID	Unique Azuga generated ID of the user in UUID format Example: `"8a94c900-9528-ccf9-0195-2a9488ff1640"`
messageTypeId Integer	Type identifier for message Example: `2`
batteryPercentage Double	Percentage of Battery at time of event Example: `0`
lastKnownLat Double	Last known latitude in degrees Example: `44.0777308`
lastKnownLon Double	Last known longitude in degrees Example: `-123.4465964`
lastKnownTime Time Stamp	Last known timestamp Example: `1756684768000`
partialUpdate Boolean	Indicates whether the data has been partially updated Example: `false`
imei_meid String	Imei ID Example: `015169000814596`
deviceTypeId Integer	Type identifier for device, 1-Datalogger Example: `1`
vendorTypeId Integer	Type identifier for vendor Example: `1`
stateId Integer	Refers to the vehicle ignition state or movement status, 0-Ignition Off and 1-Ignition On Example: `0`
deviceAssociatedVIN String	Vehicle Identification Number associated to a device Example: `1N6AF0KYXMN810439`
dataType Integer	Type of data being reported (e.g., raw, processed, diagnostic). Example: `0`
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: `0`
periodic Boolean	Indicates whether the message is part of a periodic update (e.g., routine transmission). Example: `false`
virtualTripEnd Boolean	Indicates if virtual trip ended Example: `false`
storedLocation boolean	Indicates whether the device has stored a location Example: `false`
partitionKey Integer	Key used for message partitioning (typically used in databases/queues). Example: `1112401922`