Fuel Level Remaining (%)
This webhook provides real-time updates on the current fuel level of a vehicle. It enables to optimize fuel management and avoid running out of fuel unexpectedly.
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 | Type of Event the message represents
Example: |
generatedAt | Time when the event was generated (in milliseconds). Eg:1756684774651 |
type | Type of event
Example: |
messageType | Type of Message
Example: |
serialNumber | Serial Number of the Device associated with vehicle
Example: |
processed | Indicates whether the data or event has been successfully processed by system.
Example: |
messageIndex | Unique index or identifier of the event message |
id | The unique reference ID for the given event in the system
Example: |
deviceSerial | Serial Number of the Device associated with vehicle
Example: |
deviceId | Unique ID of the device
Example: |
vehicleId | Unique ID of the vehicle
Example: |
vehicleName | Name of the vehicle
Example: |
groupId | Unique ID of the group
Example: |
groupName | Name of the Group the device/vehicle is associated to
Example: |
locationTime | Timestamp of location data
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: |
location | Current location object of the vehicle |
latitude | Latitude co-ordinate value in degrees
Example: |
longitude | Longitude co-ordinate value in degrees
Example: |
odometer | Odometer Reading of the Vehicle in kms
Example: |
tripState | Represents the current status of a vehicle's trip, indicating whether the trip is active, completed, or in another state.
Example: |
offset | Offset value
Example: |
insideHOO | Indicates if inside hours of operation
Example: |
userName | Name of the User associated to the device/vehicle
Example: |
userId | Unique Azuga generated ID of the user in UUID format
Example: |
messageTypeId | Type identifier for message
Example: |
batteryPercentage | Percentage of Battery at time of event
Example: |
lastKnownLat | Last known latitude in degrees
Example: |
lastKnownLon | Last known longitude in degrees
Example: |
lastKnownTime | Last known timestamp
Example: |
partialUpdate | Indicates whether the data has been partially updated
Example: |
imei_meid | Imei ID |
deviceTypeId | Type identifier for device, 1-Datalogger
Example: |
vendorTypeId | Type identifier for vendor
Example: |
stateId | Refers to the vehicle ignition state or movement status, 0-Ignition Off and 1-Ignition On
Example: |
deviceAssociatedVIN | Vehicle Identification Number associated to a device
Example: |
dataType | Type of data being reported (e.g., raw, processed, diagnostic).
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: |
periodic | Indicates whether the message is part of a periodic update (e.g., routine transmission).
Example: |
virtualTripEnd | Indicates if virtual trip ended
Example: |
storedLocation | Indicates whether the device has stored a location
Example: |
partitionKey | Key used for message partitioning (typically used in databases/queues).
Example: |
Updated 10 days ago
