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 String | Type of Event the message represents Example: FUEL_LEVEL_EVENT |
| 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: "1112401922" |
| 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: "2267" |
| id String, UUID | The unique reference ID for the given event in the system Example: "1c00d95d-3301-4272-b9f6-72a0224bbf9e" |
| locationStoreIdString, UUID | Unique Azuga Id of the stored location Example: "2400554a-a701-41cd-ba6f-490f6869bddb" |
| deviceSerial String | Serial Number of the Device associated with vehicle Example: "1112401922" |
| deviceId String, UUID | Unique ID of the device Example: "3f14843e-14c7-11ed-9449-43d7d49f480d" |
| vehicleId String, UUID | Unique ID of the vehicle Example: "3f14843d-14c7-11ed-9449-2f5611afcf3f" |
| vehicleName String | Name of the vehicle Example: "3339076777" |
| groupName String | Name of the Group the device/vehicle is associated to Example: "Default Group" |
| groupId String,UUID | Unique ID of the group Example: "b1bdb352-f244-11ec-afa5-4389a7c6cce9" |
| locationTime Time Stamp | Timestamp of location data Example: 1662630309000 |
| 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 |
| 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 |
| odometer Integer | Odometer Reading of the Vehicle in kms Example: 51325 |
| 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: -240 |
| connected Boolean | Whether the device is currently connected. Example: false |
| offsetChanged Boolean | Indicates if time offset has changed. Example: false |
| insideHOO Boolean | Indicates if inside hours of operation Example: true |
| protocolVersionId Integer | Version of the device communication protocol. Example: 8 |
| vehicleVersionId Integer | Protocol ID for the vehicle make/model. Example: 8 |
| userName String | Name of the User associated to the device/vehicle Example: "Mike Lynn" |
| userId String,UUID | Unique Azuga generated ID of the user in UUID format Example: "552b0839-ed76-11ec-a739-bd9d4c4a1c6d" |
| messageTypeId Integer | Type identifier for message Example: 2 |
| batteryPercentage Double | Percentage of Battery at time of event Example: 20 |
| lastKnownLat Double | Last known latitude in degrees Example: 17.691376 |
| lastKnownLon Double | Last known longitude in degrees Example: 77.611127 |
| lastKnownTime Time Stamp | Last known timestamp Example: 1662630015000 |
| processedTime Time Stamp | Time when the message was processed by the system in milliseconds Example:1733748409753 |
| partialUpdate Boolean | Indicates whether the data has been partially updated Example: false |
| imei_meid String | Imei ID Example: 2342432423423 |
| 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: 1FDSE3FLXCDA12596 |
| 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 |
| pidValueByte Double | PID value represented in byte format, typically used for simple status flags or readings. Example: 50.98039215686274 |
| periodic Boolean | Indicates whether the message is part of a periodic update (e.g., routine transmission). Example: false |
| pid Integer | Parameter ID (PID) used to identify specific OBD data like speed, fuel, etc. Example: 47 |
| 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 |
Updated 16 days ago