Skip to main content
GET
Vehicle info (V2)

Overview

Returns decoded vehicle information for a single vehicle, looked up by IMEI, 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: 10 req/s · 60/min · 6,000/hr · 144,000/day

Endpoint

GET /v2/api/vehicles/info

Query parameters

Exactly one of the following must be provided:
string
Device IMEI.
integer
Vehicle ID.
string
Vehicle Identification Number.

Response

200 OKVinDecodeItemDto[] A flat list of label/value pairs. The set of labels returned depends on what Vincario has decoded for the vehicle.

Common labels

The set of labels returned depends on what Vincario has decoded for that VIN. Below are labels observed from actual API responses:
Not all labels will be present for every vehicle — availability depends on what Vincario has on record for that VIN.

Example response

Error responses

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from POST /v2/api/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.

Query Parameters

imei
string
id
integer
vin
string

Response

Successful response

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)