Vehicle info (V2)
Vehicles
Vehicle info
Look up full vehicle metadata by IMEI, vehicle ID, or VIN. Returns all available Vincario decode data as label/value pairs.
GET
Vehicle info (V2)
Overview
Returns decoded vehicle information for a single vehicle, looked up by IMEI, legacy vehicle ID, or VIN. Exactly one of the three query parameters must be supplied. The response is a flat list of{ label, value } pairs sourced directly from the Vincario VIN decode API, so all available fields are returned without a fixed schema. Common fields include make, model, engine specs, body dimensions, and manufacturer details.
This is a new V2-only endpoint with no V1 equivalent.
Rate limit: 60 requests per 60 seconds per token.
Endpoint
GET /api/v2/vehicles/info
Query parameters
Exactly one of the following must be provided:Device IMEI.
Legacy vehicle ID.
Vehicle Identification Number.
Response
200 OK —VinDecodeItemDto[]
A flat list of label/value pairs. The set of labels returned depends on what Vincario has decoded for the vehicle.
| Field | Type | Description |
|---|---|---|
| label | string | Field name (e.g. "Make", "Model Year", "Engine Power (kW)") |
| value | string | Field value (always a string, even for numeric or array values) |
Common labels
The set of labels returned depends on what Vincario has decoded for that VIN. Below are labels observed from actual API responses:| Label | Example value |
|---|---|
| VIN | "MPBCMFF70RX582825" |
| Vehicle ID | "1647" |
| Make | "Ford" |
| Make ID | "30" |
| Model | "Ranger" |
| Model Year | "2024" |
| Product Type | "Car" |
| Body | "Pickup" |
| Engine Displacement (ccm) | "2993" |
| Engine Power (kW) | "184" |
| Engine Power (HP) | "247" |
| Fuel Type - Primary | "Diesel" |
| Fuel Type | "Petrol" |
| Transmission | "Auto" |
| Number of Gears | "10" |
| Manufacturer | "Ford Motor Company (Thailand) Limited" |
| Manufacturer Address | "33/19 Moo 6, Bo-win Sub District, Sriracha Dist Chonburl" |
| Plant Country | "Thailand" |
| Make Logo | "https://api.vincario.com/img/make/ford.svg" |
| Fuel Consumption Combined (l/100km) | "8.4" |
| Fuel Consumption Extra Urban (l/100km) | "7.5" |
| Fuel Consumption Urban (l/100km) | "10" |
| Number of Axles | "2" |
| Number of Seats | "5" |
| Weight Empty (kg) | "3350" |
| Check Digit | "0" |
| Sequential Number | "582825" |
| Number of Doors | "4" |
| Colour | "Gunmetal" |
| Fuel Capacity | "80" |
| Battery Capacity | "0" |
| Registration State | "New South Wales" |
| Registration Country | "Australia" |
Not all labels will be present for every vehicle — availability depends on what Vincario has on record for that VIN.
Example response
Error responses
| Status | Meaning |
|---|---|
| 401 | Missing or invalid token |
| 404 | Vehicle not found or not accessible |
Authorizations
JWT Bearer token obtained from POST /api/v2/authentication/token/api-key.
Lifetime: ~24 hours (86,399 seconds). Cache the token and reuse it. Re-authenticate 5 minutes before expiry.
Scoping: API key tokens are scoped to the company the key belongs to and may restrict access to a vehicle allowlist and/or action set (see token claims).
No refresh endpoint — re-authenticate with your API key when the token expires.