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
{
"messageEventType": "FUEL_LEVEL_EVENT",
"type": "OBD_EVENT_MESSAGE",
"messageType": "OBD_PERIODIC_MESSAGE",
"serialNumber": "1112401922",
"processed": true,
"messageIndex": "849597",
"id": "2400554a-a701-41cd-ba6f-490f6869bddb",
"locationStoreId": "2400554a-a701-41cd-ba6f-490f6869bddb",
"deviceSerial": "1112401922",
"deviceId": "55222e98-ed76-11ec-a739-9ffa1804e47a",
"vehicleId": "55222e97-ed76-11ec-a739-bb3293635a07",
"vehicleName": "1606G",
"groupId": "b1bdb352-f244-11ec-afa5-4389a7c6cce9",
"groupName": "Div 100",
"customerId": 17932,
"locationTime": 1733748408000,
"tripNumber": 4942,
"location": {
"latitude": 41.4238151,
"longitude": -89.6848196
},
"odometer": 210657,
"tripState": "ACTIVE",
"fixQuality": 0,
"connected": true,
"offsetChanged": false,
"offset": -360,
"insideHOO": true,
"protocolVersionId": 8,
"vehicleProtocolId": 6,
"userId": "552b0839-ed76-11ec-a739-bd9d4c4a1c6d",
"userName": "Mike Lynn",
"messageTypeId": 2,
"batteryPercentage": 0,
"lastKnownLat": 41.4375251,
"lastKnownLon": -89.6847249,
"lastKnownTime": 1733748351000,
"lastKnownFixQuality": 0,
"processedTime": 1733748409753,
"partialUpdate": false,
"imei_meid": "352602116764975",
"deviceTypeId": 1,
"vendorTypeId": 1,
"latitude": 41.4238151,
"longitude": -89.6848196,
"stateId": 0,
"deviceAssociatedVIN": "1FDSE3FLXCDA12596",
"dataType": 0,
"dataSize": 1,
"eventCount": 0,
"pidValueByte": 50.98039215686274,
"periodic": true,
"pid": 47,
"virtualTripEnd": false,
"storedLocation": false,
"partitionKey": "1112401922"
}
Reference
Field | Description |
---|---|
messageEventType | Type of Event the message represents
Example: |
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: |
locationStoreIdString, UUID | Unique Azuga Id of the stored location
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: |
groupName | Name of the Group the device/vehicle is associated to
Example: |
groupId | Unique ID of the group
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: |
connected | Whether the device is currently connected.
Example: |
offsetChanged | Indicates if time offset has changed.
Example: |
insideHOO | Indicates if inside hours of operation
Example: |
protocolVersionId | Version of the device communication protocol.
Example: |
vehicleVersionId | Protocol ID for the vehicle make/model.
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: |
processedTime | Time when the message was processed by the system in milliseconds 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: |
pidValueByte | PID value represented in byte format, typically used for simple status flags or readings.
Example: |
periodic | Indicates whether the message is part of a periodic update (e.g., routine transmission).
Example: |
pid | Parameter ID (PID) used to identify specific OBD data like speed, fuel, etc.
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 5 days ago