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
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