List Vehicle Fuel Entries

GET 
https://secure.fleetio.com/api/v1/vehicles/:id/fuel_entries

List a Vehicle's Fuel Entries

Request

Path Parameters

id stringrequired

The Fleetio ID of the relevant Vehicle.

You may also look up Vehicles by their VIN, license plate, or other external ID. See the guide on External Vehicle Ids for information on how to set this up.

Responses

200

OK

Response Headers

X-PaginationLimit

The per page limit. Currently set to 100 but subject to change at any time.

X-Pagination-Current-Page

The current page. Defaults to 1.

X-Pagination-Total-Pages

The total number of pages in the result set. Use this along with Pagination-Current-Page to determine if there are any remaining pages/records to be retrieved.

X-Pagination-Total-Count

The total number of records in the result set (across all pages).

application/json

Schema

Schema

Array [
idId (integer)required
Possible values: >= 1
created_atdate-time
The date and time at which this record was created.
Example: 2023-03-14T13:46:27-06:00
updated_atdate-time
The date and time at which this record was most recently updated.
Example: 2023-03-14T13:46:27-06:00
total_amountfloatnullable
The total amount.
Example: 1.23
total_amount_centsintegernullable
The total amount in cents.
cost_per_hrfloatnullablerequired
The automatically calculated cost per hour since the last Fuel Entry.
cost_per_kmfloatnullablerequired
The automatically calculated cost per km since the last Fuel Entry.
cost_per_mifloatnullablerequired
The automatically calculated cost per mi since the last Fuel Entry.
datedate-timerequired
The date and time at which this Fuel Entry was recorded.
Example: 2023-03-14T13:46:27-06:00
external_idstringnullablerequired
Used to uniquely identify Fuel Entries that are imported from external systems, such as Fleetcor and Wex.
fuel_type_idintegernullablerequired
The Fleetio id of the Fuel Type associated with this Fuel Entry.
Possible values: >= 1
fuel_type_namestringnullablerequired
The name of the Fuel Type associated with this Fuel Entry.
kplfloatnullablerequired
Running average recorded kilometers per liter (calculated automatically).
litersstringnullablerequired
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_hrfloatnullablerequired
Running average recorded liters per hour (calculated automatically).
lp100kfloatnullablerequired
Running average recorded liters per 100 kilometers (calculated automatically).
mpg_ukfloatnullablerequired
Running average recorded miles per UK Gallon (calculated automatically).
mpg_usfloatnullablerequired
Running average recorded miles per US Gallon (calculated automatically).
partialbooleanrequired
Used to denote a partial fuel up as opposed to a complete fuel up. Learn more about partial fuel entries here.
personalbooleanrequired
Used to denote a personal expense.
price_per_volume_unitfloatnullablerequired
The unit price for the Vehicle's volume unit.
raw_transaction_dataobjectnullablerequired
This object is dynamically populated by external fuel card integrations.
referencestringnullablerequired
Optional data field for collecting information such as the invoice number, transaction id, or receipt number, for example.
regionstringnullablerequired
resetbooleanrequired
Default value: false
uk_gallonsstringrequired
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_hrfloatnullablerequired
Running average of UK gallons used per hour. Calculated automatically.
us_gallonsstringrequired
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_hrfloatnullablerequired
Running average of US gallons used per hour. Calculated automatically.
usage_in_hrstringnullablerequired
The automatically calculated usage in hours since the most recent Fuel Entry.
usage_in_kmstringnullablerequired
The automatically calculated usage in kilometers since the most recent Fuel Entry.
usage_in_mistringnullablerequired
The automatically calculated usage in miles since the most recent Fuel Entry.
vehicle_idintegernullablerequired
The Fleetio id of the Vehicle associated with this Fuel Entry.
Possible values: >= 1
vehicle_namestringrequired
The name of the Vehicle associated with this Fuel Entry.
vendor_idintegernullablerequired
The Fleetio id of the Vendor associated with this Fuel Entry.
Possible values: >= 1
vendor_namestringnullablerequired
The name of the Vendor associated with this Fuel Entry.
custom_fieldsobjectnullable
*Full details on working with Custom Fields here.
meter_entry objectnullablerequired
A Meter Entry
idinteger
created_atdate-time
updated_atdate-time
auto_voided_atdate-timenullable
The date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in User's local time.
Example: 2023-03-14T13:46:27-06:00
categorystringnullable
A category to describe the function of this Meter Entry.
Possible values: [starting, ending, nightly, manual]
meter_typestringnullable
Indicates whether or not this Meter is a secondary Meter.
Possible values: [secondary]
meterable_idNullableId (integer)nullable
Possible values: >= 1
meterable_typestringnullable
The type of the object with which this Meter Entry is associated.
Possible values: [FuelEntry, Issue, PurchaseDetail, ServiceEntry, SubmittedInspectionItem, VehicleAssignment, WorkOrder]
valuestring
The current value of the meter.
vehicle_idNullableId (integer)nullable
Possible values: >= 1
voidboolean
Indicates whether or not this Meter Entry has been voided.
Default value: false
typestringnullable
Possible values: [GpsMeterEntry]
datedate
The date on which this Meter Entry was recorded. Formatted according to ISO-8601.
Example: 2023-03-14
geolocation objectnullablerequired
gps_devicestringnullable
original_vendorstringnullable
exception_distance_in_minumbernullable
exception_distance_in_kmnumbernullable
]

Example (auto)

[
  {
    "id": 0,
    "created_at": "2023-03-14T13:46:27-06:00",
    "updated_at": "2023-03-14T13:46:27-06:00",
    "total_amount": 1.23,
    "total_amount_cents": 0,
    "cost_per_hr": 0,
    "cost_per_km": 0,
    "cost_per_mi": 0,
    "date": "2023-03-14T13:46:27-06:00",
    "external_id": "string",
    "fuel_type_id": 0,
    "fuel_type_name": "string",
    "kpl": 0,
    "liters": "string",
    "liters_per_hr": 0,
    "lp100k": 0,
    "mpg_uk": 0,
    "mpg_us": 0,
    "partial": true,
    "personal": true,
    "price_per_volume_unit": 0,
    "raw_transaction_data": {},
    "reference": "string",
    "region": "string",
    "reset": false,
    "uk_gallons": "string",
    "uk_gallons_per_hr": 0,
    "us_gallons": "string",
    "us_gallons_per_hr": 0,
    "usage_in_hr": "string",
    "usage_in_km": "string",
    "usage_in_mi": "string",
    "vehicle_id": 0,
    "vehicle_name": "string",
    "vendor_id": 0,
    "vendor_name": "string",
    "custom_fields": {},
    "meter_entry": {
      "id": 0,
      "created_at": "2024-07-29T15:51:28.071Z",
      "updated_at": "2024-07-29T15:51:28.071Z",
      "auto_voided_at": "2023-03-14T13:46:27-06:00",
      "category": "starting",
      "meter_type": "secondary",
      "meterable_id": 0,
      "meterable_type": "FuelEntry",
      "value": "string",
      "vehicle_id": 0,
      "void": false,
      "type": "GpsMeterEntry",
      "date": "2023-03-14"
    },
    "geolocation": {
      "gps_device": "string",
      "original_vendor": "string",
      "exception_distance_in_mi": 0,
      "exception_distance_in_km": 0
    }
  }
]

401

Request could not be authenticated

application/json

Schema

Schema

statusintegerrequired

Possible values: >= 400 and <= 599

titlestringrequired

A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

detailstring

A human-readable explanation specific to this occurrence of the problem.

instancestring

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

Example (auto)

{
  "status": 0,
  "title": "string",
  "detail": "string",
  "instance": "string"
}

500

Something unexpected happened

application/json

Schema

Schema

statusintegerrequired

Possible values: >= 400 and <= 599

titlestringrequired

A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

detailstring

A human-readable explanation specific to this occurrence of the problem.

instancestring

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

Example (auto)

{
  "status": 0,
  "title": "string",
  "detail": "string",
  "instance": "string"
}

Authorization: Authorization

name: Authorizationtype: apiKeyin: headerdescription: Prefix the value with "Token", for example: "Token 76cbe06c49a64".
You can generate a new API key [here](https://secure.fleetio.com/api_keys).

name: Account-Tokentype: apiKeyin: headerdescription: You can find your Account-Token [here](https://secure.fleetio.com/api_keys)

• curl
• ruby
• python
• csharp
• go
• java
• nodejs
• php

• CURL

curl -L 'https://secure.fleetio.com/api/v1/vehicles/:id/fuel_entries' \
-H 'Accept: application/json' \
-H 'Authorization: Token <Authorization>' \
-H 'Account-Token: <Authorization>'

Request Collapse all

Base URL

https://secure.fleetio.com/api

Auth

apiKey

accountToken

Parameters

id — pathrequired

ResponseClear

Click the Send API Request button above and see the response here!