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

# List Vehicle Journeys

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

## Request

- Base URL: `https://api.volteras.com`
- URL: `https://api.volteras.com/v1/vehicles/{vehicle_id}/journeys`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/v1/oauth2/token` scopes: `vehicle:telemetry`

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.dev/volteras/apis/volteras-connect.md) - [All operations](https://skmtc.dev/volteras/apis/volteras-connect/llms.txt) - [OpenAPI document](https://skmtc.dev/volteras/apis/volteras-connect/revisions/efc902486155?raw)