---
title: "List Vehicle Charging History"
method: GET
path: "/v1/vehicles/{vehicle_id}/charging-history"
tags: ["Vehicle Charging History"]
---

# List Vehicle Charging History

`GET /v1/vehicles/{vehicle_id}/charging-history`

Retrieve a list of charging history sessions for the provided vehicle.

**Parameters:**
- `vehicle_id`: The unique identifier (ID) of the vehicle to retrieve charging history for.

**Returns:**
- A paginated list of vehicle charging history sessions.

This endpoint allows you to retrieve a paginated list of charging history sessions for a specific vehicle identified by its unique `vehicle_id`.
The list is ordered by the starting time of each charging session, with the most recent sessions appearing first.

**Note:**
- The `vehicle_id` should correspond to a valid and existing vehicle identifier.

_Find details on list filter syntax in our documentation [here](/overview/listing-filter-json)._


Possible Codes in Error Response (see [Errors](https://docs.volteras.com/api-reference/errors) for error response schema and meaning of codes):

- AUTHENTICATION_ERROR
- PAGE_SIZE_TOO_LARGE
- PAGINATED_QUERY_FILTER_CHANGED
- REQUEST_VALIDATION_ERROR
- RESOURCE_NOT_FOUND
- SERVER_ERROR

## Path parameters

- `vehicle_id` string, required — Unique internal identifier for the vehicle.

## Query parameters

- `maxPageSize` integer — Max size of the returned list.
- `pageToken` string, nullable — Page token used for pagination.
- `filter` string, nullable — Listing filter schema.

## Response `200`

Successful Response

- PageVehicleChargingSession
  - `results` VehicleChargingSession[], required — Returned data from the listing query.
    - `id` string, required
    - `vehicleId` string, required
    - `startedAt` string, date-time, required
    - `endedAt` string, date-time, nullable, required
    - `chargeDuration` integer, nullable, required
    - `latitude` number, nullable, required
    - `longitude` number, nullable, required
    - `kwhFromGrid` number, nullable, required
    - `kwhInHvb` number, nullable, required
    - `startStateOfCharge` number, nullable, required
    - `endStateOfCharge` number, nullable, required
    - `externalTemperature` number, nullable, required
    - `kwMedian` number, nullable, required
  - `nextPageToken` string, nullable, required — Next page token used for pagination.
  - `totalResults` integer, required — Total result count.

---

[API](https://skmtc.net/volteras/apis/volteras-connect.md) · [All operations](https://skmtc.net/volteras/apis/volteras-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/volteras/volteras-connect/revisions/bcb08bba814d/schema)