---
title: "Bulk Vin Connect"
method: POST
path: "/v1/vehicles/connect"
tags: ["Vehicle Connection"]
---

# Bulk Vin Connect

`POST /v1/vehicles/connect`

Connect multiple VINs to the current organization.
By default this endpoint is not enabled for organizations, please contact us to get access.
Limited to 100 VINs per 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
- DEVICE_LIMIT_REACHED
- NOT_PERMITTED
- REQUEST_VALIDATION_ERROR
- RESOURCE_NOT_FOUND
- SERVER_ERROR

## Request body

- BulkConnectVehicleRequest — Request model to connect multiple VINs
  - `vehicles` ConnectVehicleRequest[], required — The vehicles to connect
    - `vin` string, required — Vehicle identification number. Unique identifier for the vehicle.
    - `make` 'ABARTH' | 'ALFA ROMEO' | 'AUDI' | 'BMW' | 'CHRYSLER' | 'CITROEN' | 'CUPRA' | 'DODGE' | 'DS AUTOMOBILES' | 'FIAT' | 'FORD' | 'HYUNDAI' | 'JEEP' | 'KIA' | 'LANCIA' | 'LEXUS' | 'MASERATI' | 'MERCEDES BENZ' | 'MINI' | 'NISSAN' | 'OPEL' | 'PEUGEOT' | 'POLESTAR' | 'RAM' | 'RENAULT' | 'SEAT' | 'SKODA' | 'TESLA' | 'TOYOTA' | 'VAUXHALL' | 'VOLKSWAGEN' | 'VOLVO', required — Manufacturer of the vehicle
    - `countryCode` string, nullable, required — ISO two-character country code (ISO 3166-1 alpha-2, e.g. 'US', 'GB', 'FR') of the vehicle, used for retrieving vehicle specifications data. If not populated, will use the default setting (if set).
    - `registrationPlate` string, nullable — Vehicle registration plate
    - `model` string, nullable — Vehicle model
    - `modelYear` integer, nullable — Vehicle model year (the year the model was released, not the year of manufacture)
    - `batteryCapacity` number, nullable — Nominal (IE when manufactured) battery capacity in kWh of the vehicle
    - `horsepower` integer, nullable — Vehicle horsepower
    - `generation` string, nullable — Vehicle generation
    - `wltpRange` number, nullable — WLTP range of the vehicle in km
    - `registrationDate` string, date, nullable — Vehicle registration date (ISO 8601, day granularity). Must be on or before today. Used as the date-axis baseline for the service-interval cycle when the `DERIVED_SERVICING_REMINDER` setting is enabled for the organization.
    - `tags` Tag[], nullable — Tags to associate with the vehicle, for example IDs you want to associate with it, that will then be returned when you fetch the vehicle and can be used to filter vehicles in the list vehicle endpoint.
      - `key` string, required
      - `value` string, required

## Response `202`

Successful Response

- BulkConnectVehicleResponse — Response for async bulk vehicle upload endpoint on connect-api
  - `id` string, required
  - `status` 'CREATED' | 'PROCESSING' | 'COMPLETED' | 'FAILED', required
  - `createdAt` string, date-time, required

---

[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/versions/bcb08bba814d/schema)