---
title: "Bulk Vehicle Eligibility Check Results"
method: GET
path: "/v1/vehicles/eligibility/{id}/results"
tags: ["Vehicle Eligibility"]
---

# Bulk Vehicle Eligibility Check Results

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

## Request

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

Get the eligibility results for all VINs that were sent in a 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

- PageResultsSingleEligibilityResult
  - `results` SingleEligibilityResult[]
    - `rowId` integer, required
    - `vin` string, required: 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', nullable: Implemented makes enum. Input normalization and aliases are handled via `from_input` / `_missing_`, so values like "Mercedes", "MERCEDES-BENZ", or "MERCEDES_BENZ" resolve to the canonical enum. OpenAPI exposure is filtered/normalized in `__get_pydantic_json_schema__`. When updating this enum you should also consider updating the public docs: docs/public/connect-api/tools/mintlify/overview/supported-oems.mdx
    - `status` 'NOT_SUPPORTED' | 'VALIDATION_ERROR' | 'PENDING' | 'SUBMITTED' | 'INELIGIBLE_PENDING_FAILURE_REASON' | 'ELIGIBLE' | 'INELIGIBLE' | 'FAILED', required
    - `errorMessage` string, nullable: If there was an error with the check, this will have more information
  - `totalResults` integer

## Changes

- **2026-11-12** `efc902486155`: 3 warning
  - added the new `CHERY` enum value to the `results/items/make/anyOf[subschema #1: MakeEnum]/` response property for the response status `200`
  - added the new `JAECOO` enum value to the `results/items/make/anyOf[subschema #1: MakeEnum]/` response property for the response status `200`
  - added the new `OMODA` enum value to the `results/items/make/anyOf[subschema #1: MakeEnum]/` response property for the response status `200`

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