---
title: "List Vehicles"
method: GET
path: "/v1/vehicles"
tags: ["Vehicles"]
---

# List Vehicles

`GET /v1/vehicles`

Retrieve a paginated list of vehicles associated with your organization.

The endpoint lists vehicles based on the following criteria:
- Includes only vehicles that have enabled synchronization during the account connection process.
- Excludes disconnected vehicles or those not included in the OEM account.

**Returns:**
- A paginated response containing a list of vehicles.

**Note:**
- This endpoint provides a summary of each vehicle's basic details. For comprehensive vehicle data, please refer to the individual vehicle detail endpoints.

_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
- SERVER_ERROR

## Query parameters

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

## Response `200`

Successful Response

- PageVehicle
  - `results` Vehicle[], required — Returned data from the listing query.
    - `make` string, required — Manufacturer of the vehicle.
    - `model` string, nullable — Subcategory of the make, used to differentiate between different variations of a vehicle within the same make.
    - `trim` string, nullable — Subcategory of the model, used to differentiate between different variations of a vehicle within the same model. Also referred to as version or generation.
    - `modelYear` string, nullable — Year the vehicle model was released. Could be different than the year the vehicle was manufactured.
    - `vin` string, required — Vehicle identification number. Unique identifier for the vehicle.
    - `registrationPlate` string, nullable — Plate that is attached to a vehicle and displays a unique combination of letters and numbers assigned to the vehicle by a government agency. Also referred to as license plate or registration number.
    - `isRegNoValidated` boolean, nullable — Indicates whether the registration plate has been validated
    - `regNoValidatedAt` string, date-time, nullable — Timestamp of when the registration plate was last validated
    - `id` string, required — Unique internal identifier for the vehicle.
    - `metadata` VehicleMetaData, required
      - `lastSeenAt` string, date-time, nullable, required — The last recorded interaction with the vehicle endpoints. This is a timestamp in ISO 8601 format: YYYY-MM-DDThh:mm:ssTZD.
      - `consentId` string, nullable, required — Unique identifier for the consent that was used to retrieve the vehicle data.
      - `accountId` string, nullable, required — Unique identifier for the account that was used to retrieve the vehicle data.
      - `registrationDate` string, date, nullable — Vehicle registration date (ISO 8601, day granularity). Captured at vehicle upload; used as the date-axis baseline for service-interval alerts.
    - `isListening` boolean — Indicates whether the vehicle is currently accepting data ingestion and commands. Defaults to True when no listening state entries have been recorded.
    - `listeningLastUpdated` string, date-time, nullable — UTC timestamp for the most recent listening-state update, or null when no entries exist.
    - `connectionStatus` string, nullable — Connection status of the vehicle (e.g. CONNECTED, PENDING_CONNECTION, DISCONNECTED).
    - `connectionErrorCode` string, nullable — Error code if the vehicle has a connection issue.
    - `connectionErrorMessage` string, nullable — Human-readable error message for connection issues.
    - `actionCategory` string, nullable — Who must act on the connection error: CUSTOMER_ACTION, CONTACT_SUPPORT, or UNDER_REVIEW.
    - `investigationState` 'UNDER_REVIEW' | 'CONTACT_OEM' | 'CUSTOMER_ACTION' | 'RETRY' | 'ESCALATED_INTERNALLY' | 'CONFIRMED_INCOMPATIBLE' | 'SELF_RECOVERED' — Customer-facing bucket for a vehicle under Bolt investigation. Machine-readable contract shared by the portal payload and the public API. Display titles/copy are derived server-side and shipped alongside, so frontends never need to map these to text themselves.
    - `investigationSubState` 'NEEDED' | 'REQUESTED' | 'ONGOING' — CONTACT_OEM progression, driven by the linked oem_outreach lifecycle.
    - `investigationTitle` string, nullable — Display title for the current investigation status.
    - `investigationMessage` string, nullable — Customer-appropriate explanation of the current investigation state.
    - `investigationUpdatedAt` string, date-time, nullable — UTC timestamp of the most recent investigation progression.
  - `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)