Sign in
Vehicles

Get Vehicle

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 for error response schema and meaning of codes):

  • AUTHENTICATION_ERROR
  • REQUEST_VALIDATION_ERROR
  • RESOURCE_NOT_FOUND
  • SERVER_ERROR
get/v1/vehicles/{vehicle_id}

Path parameters

vehicle_idstring required

Unique internal identifier for the vehicle.

Unique internal identifier for the vehicle.

Response

Successful Response

makestring required

Manufacturer of the vehicle.

modelstring nullable

Subcategory of the make, used to differentiate between different variations of a vehicle within the same make.

trimstring 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.

modelYearstring nullable

Year the vehicle model was released. Could be different than the year the vehicle was manufactured.

vinstring required

Vehicle identification number. Unique identifier for the vehicle.

registrationPlatestring 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.

isRegNoValidatedboolean nullable

Indicates whether the registration plate has been validated

regNoValidatedAtstring date-time nullable

Timestamp of when the registration plate was last validated

idstring required

Unique internal identifier for the vehicle.

isListeningboolean

Indicates whether the vehicle is currently accepting data ingestion and commands. Defaults to True when no listening state entries have been recorded.

listeningLastUpdatedstring date-time nullable

UTC timestamp for the most recent listening-state update, or null when no entries exist.

connectionStatusstring nullable

Connection status of the vehicle (e.g. CONNECTED, PENDING_CONNECTION, DISCONNECTED).

connectionErrorCodestring nullable

Error code if the vehicle has a connection issue.

connectionErrorMessagestring nullable

Human-readable error message for connection issues.

actionCategorystring 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.

investigationTitlestring nullable

Display title for the current investigation status.

investigationMessagestring nullable

Customer-appropriate explanation of the current investigation state.

investigationUpdatedAtstring date-time nullable

UTC timestamp of the most recent investigation progression.