---
title: "List Charging Entries"
method: GET
path: "/charging_entries"
tags: ["Charging Entries"]
---

# List Charging Entries

`GET /charging_entries`

## Request

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

Returns a list of Charging Entries belonging to your account.

## Query parameters

- `start_cursor` string
- `per_page` integer
- `filter` object
  - `created_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `ended_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `started_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
  - `vehicle_id` EqFilter
    - `eq` string, required
  - `vendor_id` EqFilter
    - `eq` string, required
  - `updated_at` union
    - object
      - `lt` string, required
    - object
      - `lte` string, required
    - object
      - `gt` string, required
    - object
      - `gte` string, required
- `sort` object
  - `created_at` 'asc' | 'desc'
  - `ended_at` 'asc' | 'desc'
  - `started_at` 'asc' | 'desc'
  - `updated_at` 'asc' | 'desc'
  - `id` '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
        - `created_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `ended_at` union
          - object
            - `lt` string, required
          - object
            - `lte` string, required
          - object
            - `gt` string, required
          - object
            - `gte` string, required
      - object
        - `started_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
      - object
        - `vehicle_id` union
          - object
            - `include` string, required
          - object
            - `eq` string, required
      - object
        - `vendor_id` union
          - object
            - `include` string, required
          - object
            - `eq` string, required
  - `sorted_by` union[]: The sorts applied to the returned record set.
    - union
      - object
        - `created_at` 'asc' | 'desc'
      - object
        - `ended_at` 'asc' | 'desc'
      - object
        - `id` 'asc' | 'desc'
      - object
        - `started_at` 'asc' | 'desc'
      - object
        - `updated_at` 'asc' | 'desc'
  - `records` ChargingEntrySummary[]
    - `additional_fees_cents` integer, nullable, required: The amount, in cents, of any fees applied to the Charging Entry.
    - `approved_at` string, date-time, nullable, required: The time a Charging Entry was approved.
    - `approved_by_id` integer, nullable, required: The ID associated with the User who approved this Charging Entry.
    - `cost_per_hr` string, nullable, required: The automatically calculated cost per hour since the last Charging Entry.
    - `cost_per_km` string, nullable, required: The automatically calculated cost per kilometer since the last Charging Entry.
    - `cost_per_mi` string, nullable, required: The automatically calculated cost per mile since the last Charging Entry.
    - `discount_cents` integer, nullable, required: The amount, in cents, of any discounts applied to the Charging Entry, must be a negative number.
    - `duration_seconds` integer, required: The duration, in seconds, between the Charging Entry start and end events. If started_at and ended_at are provided, it will automatically calculate the duration_seconds using those attributes.
    - `ended_at` string, date-time, nullable, required: The date and time at which the Charging Entry ended.
    - `geolocation` Geolocation, nullable, required
      - `gps_device` string, nullable
      - `original_vendor` string, nullable
      - `exception_distance_in_mi` number, nullable
      - `exception_distance_in_km` number, nullable
    - `km_per_kwh` string, required: The automatically calculated kilometers per kilowatt hour since the last Charging Entry.
    - `mi_per_kwh` string, required: The automatically calculated miles per kilowatt hour since the last Charging Entry.
    - `personal` boolean, required: Indicates whether this Charging Entry was for personal use. This field is `false` if not provided.
    - `price_per_kwh_cents` string, nullable, required: The unit price per kilowatt hour for the Charging Entry.
    - `reference` string, nullable, required: Optional data field for collecting information such as the invoice number, transaction id, or receipt number, for example.
    - `started_at` string, date-time, required: The date and time at which this Charging Entry started.
    - `status` 'in_progress' | 'target_reached' | 'ready_for_review' | 'manually_completed' | 'approved' | 'auto_approved' | 'unknown', required: The status of the Charging Entry. This field is "manually_completed" if not provided.
    - `total_amount_cents` integer, nullable, required: The total cost, in cents, of the Charging Entry.
    - `total_kwh` string, required: The total kilowatt hours of the Charging Entry.
    - `usage_in_hr` string, nullable, required: The automatically calculated usage in hours since the most recent Charging Entry.
    - `usage_in_km` string, nullable, required: The automatically calculated usage in kilometers since the most recent Charging Entry.
    - `usage_in_mi` string, nullable, required: The automatically calculated usage in miles since the most recent Charging Entry.
    - `vehicle_id` integer, required: The Fleetio `id` of the [Vehicle](/docs/api/vehicles) associated with this Charging Entry.
    - `vendor_id` integer, nullable, required: The Fleetio `id` of the [Vendor](/docs/api/vendors) associated with this Charging Entry.
    - `comments_count` integer, required: The number of comments on this Charging Entry.
    - `documents_count` integer, required: The number of documents added to this Charging Entry.
    - `images_count` integer, required: The number of images added to this Charging Entry.

## 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/charging_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)