---
title: "List Vehicle Journeys"
method: GET
path: "/v1/vehicles/{vehicle_id}/journeys"
tags: ["Vehicle Journeys"]
---

# List Vehicle Journeys

`GET /v1/vehicles/{vehicle_id}/journeys`

Retrieve a paginated list of journeys for the provided vehicle.

**Parameters:**
- `vehicle_id`: The unique identifier (ID) of the vehicle to retrieve journeys for.
- Pagination parameters as query params.
- Filter parameters on any of the journey fields - see https://docs.volteras.com/overview/listing-filter-json for how to construct.

**Returns:**
- A paginated list of vehicle journeys.

This endpoint allows you to retrieve a paginated list of journeys for a specific vehicle identified by its unique `vehicle_id`.
The list is ordered by the start timestamp of each journey, with the most recent journeys appearing first.

**Note:**
- The `vehicle_id` should correspond to a valid and existing vehicle identifier.
- This endpoint returns the estimated total result count.


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

- PageWithEstimatedTotalResultsVehicleJourneyResponse
  - `results` VehicleJourneyResponse[], required — Returned data from the listing query.
    - `id` string, required — Unique identifier for the journey
    - `vehicleId` string, required — Unique identifier for the vehicle
    - `distanceTravelledKm` number, nullable — Distance travelled in kilometers
    - `odometerStart` number, nullable — Odometer reading at journey start in kilometers
    - `odometerEnd` number, nullable — Odometer reading at journey end in kilometers
    - `energyUsedKwh` number, nullable — Energy used during journey in kWh
    - `energyStartKwh` number, nullable — Energy remaining at journey start in kWh
    - `energyEndKwh` number, nullable — Energy remaining at journey end in kWh
    - `socUsed` number, nullable — State of charge used during journey in percent
    - `socStart` number, nullable — State of charge at journey start in percent
    - `socEnd` number, nullable — State of charge at journey end in percent
    - `startTimestamp` string, date-time, required — Journey start timestamp
    - `stopTimestamp` string, date-time, nullable — Journey stop timestamp
    - `startLatitude` number, nullable — Latitude at journey start
    - `startLongitude` number, nullable — Longitude at journey start
    - `stopLatitude` number, nullable — Latitude at journey stop
    - `stopLongitude` number, nullable — Longitude at journey stop
    - `vin` string, required — Vehicle identification number
  - `nextPageToken` string, nullable, required — Next page token used for pagination.
  - `estimatedTotalResults` integer, required — Estimated 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)