FLfleetio
Meter Entries

Create Meter Entry

Create a new Meter Entry. If you need to create many Meter Entries at once, use the Bulk API to avoid Rate Limiting errors.

post/meter_entries

Request

Request body

vehicle_idinteger required
valuenumber float required

The value of the meter. The unit can be configured at the Account level, or overridden at the Vehicle level.

datestring date-time required

Meter Entries must follow the correct sequence, incrementing in value by date. For each entry, Fleetio validates to ensure that the value falls between any entries logged before and/or after. We recommend using ISO-8601 formatted dates to avoid ambiguity.

voidboolean

Whether to mark this Meter Entry void or not. See Voiding Meter Entries.

meter_type'secondary' nullable

If this is a secondary meter reading, use this field.

If the vehicle's secondary meter is disabled, secondary meter values will be hidden in the web and mobile views until enabled.

Example request

{
  "date": "2023-03-14T13:46:27-06:00"
}

Response

OK

idinteger required
created_atstring date-time

The date and time at which this record was created.

updated_atstring date-time

The date and time at which this record was most recently updated.

account_idinteger required
auto_voided_atstring date-time nullable required

The date and time at which this Meter Entry was automatically voided.

category'starting' | 'ending' | 'nightly' | 'manual' nullable required

A category to describe the function of this Meter Entry.

meter_type'secondary' nullable required

Indicates whether this Meter Entry is for a secondary meter.

meterable_idinteger nullable required
meterable_type'FuelEntry' | 'Issue' | 'PurchaseDetail' | 'ServiceEntry' | 'SubmittedInspectionItem' | 'VehicleAssignment' | 'WorkOrder' nullable required

The type of the object with which this Meter Entry is associated.

valuestring required

The current value of the meter.

vehicle_idinteger nullable required
voidboolean required

Indicates whether or not this Meter Entry has been voided.

gps_providerobject nullable required

The GPS provider that submitted this Meter Entry.

datestring date required

The date on which this Meter Entry was recorded.

vehicle_archived_atstring date-time nullable

The date and time at which the Vehicle associated with this Meter Entry was archived, if applicable.

auto_void_reasonstring nullable

The reason this Meter Entry was automatically voided.

is_sampleboolean

Indicates whether or not this Meter Entry is sample data.

gps_device_idinteger nullable
sourcestring nullable

The source of this Meter Entry.

active_meter_conflicts_caused_countinteger

The number of active meter conflicts caused by this Meter Entry.

Example response

{
  "created_at": "2023-03-14T13:46:27-06:00",
  "updated_at": "2023-03-14T13:46:27-06:00",
  "auto_voided_at": "2023-03-14T13:46:27-06:00",
  "date": "2023-03-14"
}

Changes

No recorded changes to this operation across all 6 revisions of this API.