---
title: "List Fuel Entries"
method: GET
path: "/fuel_entries"
tags: ["Fuel Entries"]
---

# List Fuel Entries

`GET /fuel_entries`

## Request

- Base URL: `https://secure.fleetio.com/api`
- URL: `https://secure.fleetio.com/api/fuel_entries`
- Auth: API key in header `Authorization` and API key in header `Account-Token`
- TypeScript: <https://skmtc.dev/fleetio/apis/fleetio-developer-api/docs/fuel_entries/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of Fuel Entries belonging to your account.

## Query parameters

- `start_cursor` string
- `per_page` integer
- `filter` object
  - `external_id` union
    - object
      - `like` string, required
    - object
      - `eq` string, required
  - `vehicle_id` EqFilter
    - `eq` string, required
  - `vendor_id` EqFilter
    - `eq` string, required
  - `date` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `created_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `updated_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
- `sort` object
  - `id` 'asc' | 'desc'
  - `date` 'asc' | 'desc'
  - `created_at` 'asc' | 'desc'
  - `updated_at` 'asc' | 'desc'

## Response `200`

OK

- object
  - `start_cursor` string, nullable: The current start cursor of the records returned.
  - `next_cursor` string, nullable: The next cursor to retrieve the next page of records.
  - `per_page` integer: The maximum number of records returned.
  - `estimated_remaining_count` integer: The number of remaining records including the returned records, up to a maximum of 500.
  - `filtered_by` union[]: The filters applied to the returned record set.
    - union
      - object
        - `external_id` union
          - object
            - `like` string, required
          - object
            - `eq` string, required
      - object
        - `vehicle_id` EqFilter
          - `eq` string, required
      - object
        - `vendor_id` EqFilter
          - `eq` string, required
      - object
        - `date` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `created_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `updated_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
  - `sorted_by` union[]: The sorts applied to the returned record set.
    - union
      - object
        - `date` 'asc' | 'desc'
      - object
        - `created_at` 'asc' | 'desc'
      - object
        - `updated_at` 'asc' | 'desc'
      - object
        - `id` 'asc' | 'desc'
  - `records` FuelEntrySummary[]
    - `id` integer
    - `external_id` string, nullable: Used to uniquely identify Fuel Entries that are imported from external systems, such as Fleetcor and Wex.
    - `fuel_type_id` integer, nullable: The Fleetio `id` of the `Fuel Type` associated with this Fuel Entry.
    - `vehicle_id` integer, nullable: The Fleetio `id` of the [Vehicle](/docs/api/vehicles) associated with this Fuel Entry.
    - `vendor_id` integer, nullable: The Fleetio `id` of the [Vendor](/docs/api/vendors) associated with this Fuel Entry.
    - `partial` boolean: Used to denote a partial fuel up as opposed to a complete fuel up. Learn more about partial Fuel Entries [here](https://help.fleetio.com/s/article/Partial-Fuel-Entries).
    - `personal` boolean: Used to denote a personal expense.
    - `reference` string, nullable: Optional data field for collecting information such as the invoice number, transaction id, or receipt number, for example.
    - `region` string, nullable
    - `reset` boolean
    - `images_count` integer: The count of Images associated with this Fuel Entry.
    - `documents_count` integer: The count of Documents associated with this Fuel Entry.
    - `comments_count` integer: The count of Comments associated with this Fuel Entry.
    - `watchers_count` integer: The count of Watchers associated with this Fuel Entry.
    - `is_sample` boolean
    - `date` string, date-time: The date and time at which this Fuel Entry was recorded.
    - `created_at` string, date-time: The date and time this Fuel Entry was created.
    - `updated_at` string, date-time: The date and time this Fuel Entry was last updated.
    - `cost_per_hr` string, nullable: The automatically calculated cost per hour since the last Fuel Entry.
    - `cost_per_km` string, nullable: The automatically calculated cost per km since the last Fuel Entry.
    - `cost_per_mi` string, nullable: The automatically calculated cost per mi since the last Fuel Entry.
    - `kpl` string, nullable: Running average recorded kilometers per liter (calculated automatically).
    - `uk_gallons` string: The fuel volume amount in UK gallons. This field will _only_ be used if the [Vehicle](/docs/api/vehicles) is [configured to use UK Gallons](https://help.fleetio.com/s/article/Fuel-Settings#vehicle-settings), otherwise it will be ignored.
    - `uk_gallons_per_hr` string, nullable: Running average of UK gallons used per hour. Calculated automatically.
    - `us_gallons` string: The fuel volume amount in US gallons. This field will _only_ be used if the [Vehicle](/docs/api/vehicles) is [configured to use US Gallons](https://help.fleetio.com/s/article/Fuel-Settings#vehicle-settings), otherwise it will be ignored.
    - `us_gallons_per_hr` string, nullable: Running average of US gallons used per hour. Calculated automatically.
    - `liters` string, nullable: The fuel volume amount in liters. This field will _only_ be used if the [Vehicle](/docs/api/vehicles) is [configured to use liters](https://help.fleetio.com/s/article/Fuel-Settings#vehicle-settings), otherwise it will be ignored.
    - `liters_per_hr` string, nullable: Running average recorded liters per hour (calculated automatically).
    - `lp100k` string, nullable: Running average recorded liters per 100 kilometers (calculated automatically).
    - `mpg_uk` string, nullable: Running average recorded miles per UK Gallon (calculated automatically).
    - `mpg_us` string, nullable: Running average recorded miles per US Gallon (calculated automatically).
    - `price_per_volume_unit` string, nullable: The unit price for the `Vehicle`'s volume unit.
    - `usage_in_hr` string, nullable: The automatically calculated usage in hours since the most recent Fuel Entry.
    - `usage_in_km` string, nullable: The automatically calculated usage in kilometers since the most recent Fuel Entry.
    - `usage_in_mi` string, nullable: The automatically calculated usage in miles since the most recent Fuel Entry.
    - `total_amount_cents` integer: The total amount of the Fuel Entry in cents.
    - `attachment_permissions` AttachmentPermissions, nullable
      - `read_photos` boolean: Indicates whether the user has read permission for photos.
      - `manage_photos` boolean: Indicates whether the user has permission to manage (eg. upload, delete) photos.
      - `read_documents` boolean: Indicates whether the user has read permission for documents.
      - `manage_documents` boolean: Indicates whether the user has permission to manage (eg. upload, delete) documents.
    - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields).
    - `vehicle` VehicleMini: A Vehicle
      - `id` integer, required
      - `name` string, required: This vehicle's name.
      - `color` string, nullable: The color of this Vehicle.
      - `license_plate` string, nullable: The license plate number of this Vehicle.
      - `vin` string, nullable: The Vehicle Identification Number of this Vehicle.
      - `year` string, nullable: This Vehicle's model year.
      - `make` string, nullable: The name of this Vehicle's manufacturer.
      - `model` string, nullable: The name of the model of this Vehicle.
      - `trim` string, nullable: The trim level of this Vehicle.
      - `registration_expiration_month` integer, nullable: The month in which this Vehicle's registration expires.
      - `registration_state` string, nullable: The state, province, or territory in which this Vehicle is registered.
      - `default_image_url_small` string, nullable: The URL of a small-sized version of the default image for this Vehicle.
    - `meter_entry` VehicleMeterEntry, nullable: A Meter Entry
      - `id` integer
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `auto_voided_at` string, date-time, nullable: The date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in `User`'s local time.
      - `category` 'starting' | 'ending' | 'nightly' | 'manual', nullable: A category to describe the function of this Meter Entry.
      - `meter_type` 'secondary', nullable: Indicates whether or not this Meter is a secondary Meter.
      - `meterable_id` integer, nullable
      - `meterable_type` 'FuelEntry' | 'Issue' | 'PurchaseDetail' | 'ServiceEntry' | 'SubmittedInspectionItem' | 'VehicleAssignment' | 'WorkOrder', nullable: The type of the object with which this Meter Entry is associated.
      - `value` string: The current value of the meter.
      - `vehicle_id` integer, nullable
      - `void` boolean: Indicates whether or not this Meter Entry has been voided.
      - `type` 'GpsMeterEntry', nullable
      - `date` string, date: The date on which this Meter Entry was recorded. Formatted according to ISO-8601.
    - `vendor` VendorMini, nullable: A Vendor
      - `name` string, required: The name of the Vendor.
      - `phone` string, nullable, required: The phone number of the Vendor.
      - `city` string, nullable, required: The city of the Vendor.
      - `region` string, nullable, required: The region, state, province, or territory of the Vendor.
      - `postal_code` string, nullable, required: The postal code or ZIP code of the Vendor.
      - `country` string, nullable, required: The country of the Vendor.
      - `external_id` string, nullable, required: The external identifier of the Vendor.

## Other responses

- `400`: The format or parameters of the request was invalid
- `401`: Request could not be authenticated
- `500`: Something unexpected happened

## Changes

- **2026-11-06** `49558d744bd7`: 1 info
  - for the `query` request parameter `per_page`, the min was decreased from `2.00` to `1.00`

[Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/fuel_entries/get.md)

---

[API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)