Fuel Entries

Retrieve Fuel Entry

Retrieve the details of an existing Fuel Entry.

get/fuel_entries/{id}

Request

Path parameters

idstring required

The id of the relevant record

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.

cost_per_hrnumber float nullable required

The automatically calculated cost per hour since the last Fuel Entry.

cost_per_kmnumber float nullable required

The automatically calculated cost per km since the last Fuel Entry.

cost_per_minumber float nullable required

The automatically calculated cost per mi since the last Fuel Entry.

datestring date-time required

The date and time at which this Fuel Entry was recorded.

external_idstring nullable required

Used to uniquely identify Fuel Entries that are imported from external systems, such as Fleetcor and Wex.

fuel_type_idinteger nullable required

The Fleetio id of the Fuel Type associated with this Fuel Entry.

fuel_type_namestring nullable required

The name of the Fuel Type associated with this Fuel Entry.

kplnumber float nullable required

Running average recorded kilometers per liter (calculated automatically).

litersstring nullable required

The fuel volume amount in liters. This field will only be used if the Vehicle is configured to use liters, otherwise it will be ignored.

liters_per_hrnumber float nullable required

Running average recorded liters per hour (calculated automatically).

lp100knumber float nullable required

Running average recorded liters per 100 kilometers (calculated automatically).

mpg_uknumber float nullable required

Running average recorded miles per UK Gallon (calculated automatically).

mpg_usnumber float nullable required

Running average recorded miles per US Gallon (calculated automatically).

partialboolean required

Used to denote a partial fuel up as opposed to a complete fuel up. Learn more about partial Fuel Entries here.

personalboolean required

Used to denote a personal expense.

price_per_volume_unitnumber float nullable required

The unit price for the Vehicle's volume unit.

raw_transaction_dataobject nullable required

This object is dynamically populated by external fuel card integrations.

referencestring nullable required

Optional data field for collecting information such as the invoice number, transaction id, or receipt number, for example.

regionstring nullable required
resetboolean required
uk_gallonsstring required

The fuel volume amount in UK gallons. This field will only be used if the Vehicle is configured to use UK Gallons, otherwise it will be ignored.

uk_gallons_per_hrnumber float nullable required

Running average of UK gallons used per hour. Calculated automatically.

us_gallonsstring required

The fuel volume amount in US gallons. This field will only be used if the Vehicle is configured to use US Gallons, otherwise it will be ignored.

us_gallons_per_hrnumber float nullable required

Running average of US gallons used per hour. Calculated automatically.

usage_in_hrstring nullable required

The automatically calculated usage in hours since the most recent Fuel Entry.

usage_in_kmstring nullable required

The automatically calculated usage in kilometers since the most recent Fuel Entry.

usage_in_mistring nullable required

The automatically calculated usage in miles since the most recent Fuel Entry.

vehicle_idinteger nullable required

The Fleetio id of the Vehicle associated with this Fuel Entry.

vehicle_namestring required

The name of the Vehicle associated with this Fuel Entry.

vendor_idinteger nullable required

The Fleetio id of the Vendor associated with this Fuel Entry.

vendor_namestring nullable required

The name of the Vendor associated with this Fuel Entry.

is_sampleboolean required
custom_fieldsCustomFields nullable

*Full details on working with Custom Fields here.

fuel_economy_for_current_userstring nullable
fuel_economy_units_for_current_userstring
total_amountnumber float required

The total amount of the Fuel Entry.

comments_countinteger required

The number of comments made on this record.

images_countinteger required

The number of images attached to this record.

documents_countinteger required

The number of documents attached to this record.

Example response

{
  "created_at": "2023-03-14T13:46:27-06:00",
  "updated_at": "2023-03-14T13:46:27-06:00",
  "date": "2023-03-14T13:46:27-06:00",
  "meter_entry": {
    "auto_voided_at": "2023-03-14T13:46:27-06:00",
    "date": "2023-03-14"
  },
  "comments": [
    {
      "created_at": "2023-03-14T13:46:27-06:00",
      "updated_at": "2023-03-14T13:46:27-06:00"
    }
  ],
  "images": [
    {
      "created_at": "2023-03-14T13:46:27-06:00",
      "updated_at": "2023-03-14T13:46:27-06:00"
    }
  ],
  "documents": [
    {
      "created_at": "2023-03-14T13:46:27-06:00",
      "updated_at": "2023-03-14T13:46:27-06:00"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.