---
title: "Bulk Vehicle Connect Vin Results"
method: GET
path: "/v1/vehicles/connect/{id}/results"
tags: ["Vehicle Connection"]
---

# Bulk Vehicle Connect Vin Results

`GET /v1/vehicles/connect/{id}/results`

Get details of individual VINs that were sent in the connection request.


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

- AUTHENTICATION_ERROR
- NOT_PERMITTED
- REQUEST_VALIDATION_ERROR
- RESOURCE_NOT_FOUND
- SERVER_ERROR

## Path parameters

- `id` string, required

## Query parameters

- `maxPageSize` integer, nullable — Max size of the returned list.
- `currentPage` integer, nullable — Current page

## Response `200`

Successful Response

- PageResultsVehicleInputResponse
  - `results` VehicleInputResponse[]
    - `vehicleId` string, nullable — Vehicle ID of the connected vehicle. This will only be set if the vehicle was connected successfully
    - `vehicleInputId` string, required — ID of the vehicle input (IE this specific attempt for the VIN upload).
    - `status` 'CONNECTED' | 'PROCESSING' | 'PENDING' | 'CONNECTION_REQUIRED' | 'INCOMPATIBLE' | 'ERROR', required — Status of a vehicle connection attempt.
    - `message` string, required — Message for the response.
    - `errors` VehicleInputResponseError[] — Errors for the response, if any were raised
      - `code` 'OEM_INCORRECT_REGION' | 'OEM_VEHICLE_OFFLINE' | 'OEM_VEHICLE_REMOTE_ACCESS_DISABLED' | 'OEM_VEHICLE_DATA_SHARING_DISABLED' | 'FLEET_CONSENT_MISSING' | 'OEM_AUTH_DRIVER_IS_NOT_PRIMARY_USER' | 'OEM_DEVICE_NOT_FOUND' | 'OEM_VEHICLE_NOT_COMPATIBLE' | 'OEM_VEHICLE_UPDATE_REQUIRED' | 'DEVICE_LIMIT_REACHED' | 'NOT_PERMITTED' | 'VIN_UPLOAD_INVALID_FORMAT' | 'INVALID_VIN' | 'VIN_CHECK_NOT_SUPPORTED' | 'VEHICLE_ALREADY_ADDED_TO_ORGANIZATION' | 'VEHICLE_ALREADY_ADDED_CONNECTION_REQUIRED' | 'VEHICLE_ALREADY_ADDED_INCOMPATIBLE' | 'VEHICLE_ALREADY_ADDED_PENDING_CONNECTION' | 'VIN_UPLOAD_NOT_SUPPORTED' | 'VIN_BLACKLISTED' | 'SUBJECTS_NOT_ASSIGNABLE', required — Error code
      - `message` string, required — Error message
      - `actionCategory` string, nullable — Category indicating who must act on this error: CUSTOMER_ACTION, CONTACT_SUPPORT, or UNDER_REVIEW
    - `canRetry` boolean, nullable — Whether the client can retry the upload on error.
    - `vin` string, nullable — The VIN
    - `make` string, nullable — The vehicle make
    - `model` string, nullable — The vehicle model
    - `countryCode` string, nullable — ISO two-character country code of the vehicle captured during upload, if provided.
    - `registrationPlate` string, nullable — Vehicle registration plate captured during upload, if provided.
    - `modelYear` integer, nullable — Vehicle model year captured during upload, if provided.
    - `registrationDate` string, date, nullable — Vehicle registration date captured during upload, if provided.
    - `owners` string[] — Owner identifiers (emails or group names) captured during upload.
    - `tags` Tag[] — Tags provided during the upload.
      - `key` string, required
      - `value` string, required
    - `wasAlreadyConnected` boolean — True when this row landed on a vehicle that was already enrolled — i.e. a re-upload that updated existing tags/owners/etc. False for a fresh enrolment. Always false unless the row completed successfully on an existing vehicle.
    - `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.
  - `totalResults` integer

---

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