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