Skip to main content
GET
Decodes vehicle identification numbers and answers catalogue questions (makes, models, manufacturers, vehicle variables). Choose what to do with type.

Parameters

string
default:"decode"
decode (default), batch, wmi, makes, manufacturers, variables or canadian.
string
The VIN (decode), VINs separated by new lines, up to 50 (batch), a WMI (wmi), or the make / manufacturer / variable name the chosen search_type needs. Not needed for makes+all, manufacturers+all/parts, variables+list and canadian.
number
decode: model year, improves accuracy.
boolean
decode: true for the extended field set.
string
makes: all, manufacturer, vehicletype, models, vehicletypes. manufacturers: all, details, wmis, parts. variables: list, values.
number
makes with manufacturer/models, and canadian: model year.
string
makes+models and manufacturers+wmis: vehicle type filter.
string
manufacturers+all: manufacturer type filter.
number
manufacturers+all/parts: page number.
string
manufacturers+parts: CFR part, default 565.
string
manufacturers+parts: start date (required there).
string
manufacturers+parts: end date (required there).
string
canadian: make.
string
canadian: model.
string
canadian: Metric (default) or US.

Headers

string
required
Your API key.

Usage

Counts as one lookup against your plan’s daily allowance (Max: unlimited). When the allowance is used up, the lookup can continue at a per-lookup price charged to your balance (the module’s page in the dashboard shows the price). The price applies even when the lookup finds nothing; a lookup that fails because of an error on our side is not charged.

Example request

SDK example

The same request with the official SDKs. Each one reads your key from OSINTCAT_API_KEY.

Response

The answer depends on type: decode and wmi return one object with the decoded fields (empty strings for fields the VIN does not carry); batch and the catalogue types return a list. Decoded VINs are cached for an hour.

Errors

See Errors for the responses every endpoint can return.