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

## Request

- Base URL: `https://api.volteras.com`
- URL: `https://api.volteras.com/v1/vehicles/connect/{id}/results`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/v1/oauth2/token`
- TypeScript: <https://skmtc.dev/volteras/apis/volteras-connect/docs/v1/vehicles/connect/:id/results/get.ts> (a function with typed inputs; its response is checked against the schema)

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' | 'DISCONNECTED', 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' | 'OEM_ACTIVATION_PENDING' | 'OEM_VEHICLE_IN_TRANSPORT_MODE' | 'OEM_VEHICLE_ENROLLED_WITH_ANOTHER_PROVIDER' | '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

## Changes

- **2026-10-22** `854466c24473`: 1 warning
  - added the new `OEM_ACTIVATION_PENDING` enum value to the `results/items/errors/items/code` response property for the response status `200`
- **2026-10-20** `704476f70f48`: 1 warning
  - added the new `DISCONNECTED` enum value to the `results/items/status` response property for the response status `200`
- **2026-09-16** `bc940dff2d3e`: 1 warning
  - added the new `OEM_VEHICLE_IN_TRANSPORT_MODE` enum value to the `results/items/errors/items/code` response property for the response status `200`
- **2026-08-24** `12b3d5bf6119`: 1 warning
  - added the new `OEM_VEHICLE_ENROLLED_WITH_ANOTHER_PROVIDER` enum value to the `results/items/errors/items/code` response property for the response status `200`

[Operation history](https://skmtc.dev/volteras/apis/volteras-connect/changes/v1/vehicles/connect/:id/results/get.md)

---

[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/87f865622b4a?raw)