---
title: "Get Vehicle"
method: GET
path: "/v1/vehicles/{vehicle_id}"
tags: ["Vehicles"]
---

# Get Vehicle

`GET /v1/vehicles/{vehicle_id}`

Retrieve detailed information about a vehicle by specifying its unique identifier (ID).

**Returns:**
- A response containing detailed information about the vehicle.


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

- AUTHENTICATION_ERROR
- REQUEST_VALIDATION_ERROR
- RESOURCE_NOT_FOUND
- SERVER_ERROR

## Path parameters

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

## Response `200`

Successful Response

- Vehicle
  - `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.

---

[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)