---
title: "Bulk Vin Eligibility Check"
method: POST
path: "/v1/vehicles/eligibility"
tags: ["Vehicle Eligibility"]
---

# Bulk Vin Eligibility Check

`POST /v1/vehicles/eligibility`

## Request

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

Check the eligibility of multiple VINs


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

## Request body

- BulkVinEligibilityRequest
  - `vins` SingleEligibilityEntry[], required: List of vehicle identification numbers. Each VIN must be a 17-character alphanumeric string.
    - `vin` string: Vehicle identification number (VIN).
    - `make` 'ABARTH' | 'ALFA ROMEO' | 'AUDI' | 'BMW' | 'CHERY' | 'CHRYSLER' | 'CITROEN' | 'CUPRA' | 'DODGE' | 'DS AUTOMOBILES' | 'FIAT' | 'FORD' | 'HYUNDAI' | 'JAECOO' | 'JEEP' | 'KIA' | 'LANCIA' | 'LEXUS' | 'MASERATI' | 'MERCEDES BENZ' | 'MINI' | 'NISSAN' | 'OMODA' | 'OPEL' | 'PEUGEOT' | 'POLESTAR' | 'RAM' | 'RENAULT' | 'SEAT' | 'SKODA' | 'TESLA' | 'TOYOTA' | 'VAUXHALL' | 'VOLKSWAGEN' | 'VOLVO': Manufacturer of the vehicle
    - `countryCode` string, nullable, required: ISO two-character country code for the VIN being checked.

## Response `202`

Successful Response

- BulkVinEligibilityResponse: Response for async bulk eligibility request on connect-api
  - `id` string, required
  - `status` 'CREATED' | 'PROCESSING' | 'COMPLETED' | 'FAILED', required
  - `createdAt` string, date-time, required

## Changes

- **2026-11-12** `efc902486155`: 3 info
  - added the new `CHERY` enum value to the request property `vins/items/make`
  - added the new `JAECOO` enum value to the request property `vins/items/make`
  - added the new `OMODA` enum value to the request property `vins/items/make`

[Operation history](https://skmtc.dev/volteras/apis/volteras-connect/changes/v1/vehicles/eligibility/post.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/efc902486155?raw)