The NeoVIN Decoder API is an advanced VIN decoder that provides comprehensive vehicle specifications and attributes derived from a valid 17-character Vehicle Identification Number (VIN). This service is designed to return detailed information about a vehicle, including its make, model, year, trim, options packages, installed equipment, and more.
This API is particularly useful for applications that require in-depth vehicle information, including options and features, making it ideal for automotive marketplaces, inventory management systems, and other applications that need detailed vehicle specifications.
It is an enhanced version of the Basic VIN Decoder, offering more detailed data and additional features.
GET https://api.marketcheck.com/v2/decode/car/neovin/{vin}/specs
Path Parameters:
vin
: The 17-character VIN of the vehicle to decode.The following example demonstrates a basic request to the NeoVIN Decoder API:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/decode/car/neovin/1FTEW1C59LKE56394/specs',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
The NeoVIN Decoder API provides comprehensive vehicle specifications and detailed information using a valid 17-character Vehicle Identification Number (VIN). This enhanced decoder offers extensive data including options packages, installed equipment, features, and confidence scoring.
Available parameters for enhanced VIN decoding requests:
Your MarketCheck API authentication key. Required for every request, unless OAuth is used.
If true
, includes generic VIN decode information in NeoVIN responses.
If true
, includes available options details in NeoVIN responses.
The following parameters are required for NeoVIN decoding requests:
include_generic=true
to include additional generic specifications alongside detailed NeoVIN datainclude_available_options=true
to include available options details alongside detailed NeoVIN dataThe NeoVIN Decoder API returns comprehensive vehicle specifications and detailed information in a structured JSON format.
interface Response {
vin: string; // Original VIN provided for decoding
squish_vin: string; // Squish VIN representation
year: number; // Model year of the vehicle
make: string; // Vehicle manufacturer name
model: string; // Vehicle model name
vehicle_type: string; // Vehicle classification
listing_confidence: string; // Confidence level for listing accuracy
trim: string; // Trim level or variant
trim_confidence: string; // Confidence score for trim identification
version: string; // Specific version or sub-model
version_confidence: string; // Confidence score for version identification
transmission: string; // Transmission type
transmission_confidence: string; // Confidence score for transmission
transmission_description: string; // Detailed transmission description
drivetrain: string; // Drivetrain configuration
powertrain_type: string; // Powertrain classification
engine: string; // Engine description
fuel_type: string; // Fuel type
doors: number; // Number of doors
body_type: string; // Body style
body_subtype: string; // Body substyle
weight: number; // Vehicle weight
width: number; // Vehicle width
height: number; // Vehicle height
length: number; // Vehicle length
city_mpg: number; // City fuel economy
highway_mpg: number; // Highway fuel economy
manufacturer_code: string; // Manufacturer's internal code
package_code: string; // Package code
msrp: number; // Manufacturer's Suggested Retail Price
delivery_charges: number; // Delivery and destination charges
installed_options_msrp: number; // MSRP of installed options
combined_msrp: number; // Total MSRP including options
interior_color: Color; // Interior color information
exterior_color: Color; // Exterior color information
country: string; // Country of manufacture
seating_capacity: number; // Number of seats
options_packages: string; // Installed options packages
installed_options_details: InstalledOption[]; // Detailed options information
features: Record<string, Feature[]>; // Categorized features
high_value_features: Record<string, HighValueFeature[]>; // High-value features
installed_equipment: Record<string, InstalledEquipment[]>; // Installed equipment details
available_options_details: AvailableOption[]; // Detailed available options information
generic?: Record<string, string>; // Generic specifications if requested
created_at: number; // Creation timestamp
created_at_date: string; // Creation date string
updated_at: number; // Last update timestamp
updated_at_date: string; // Last update date string
decode_version: number; // Version of decode algorithm used
}
interface Color {
code: string; // Color code
name: string; // Color name
confidence: string; // Confidence score for color identification
base: string; // Base color family
}
interface AvailableOption {
code: string; // Option code
name: string; // Option name
msrp: string; // Option MSRP
type: string; // Option type
}
interface InstalledOption {
code: string; // Option code
name: string; // Option name
msrp: string; // Option MSRP
type: string; // Option type
confidence: string; // Confidence score
verified: boolean; // Whether option is verified
rule: string; // Rule used for identification
sale_price: string; // Sale price if different from MSRP
}
interface Feature {
category: string; // Feature category
feature_type: string; // Type of feature
description: string; // Feature description
}
interface HighValueFeature {
category: string; // Feature category
description: string; // Feature description
}
interface InstalledEquipment {
category: string; // Equipment category
item: string; // Equipment item
attribute: string; // Equipment attribute
location: string; // Equipment location
value: string; // Equipment value
}
include_generic=true
, includes generic specifications alongside detailed datainclude_available_options=true
includes available options details alongside detailed NeoVIN dataStatus Code | Description | Common Causes |
---|---|---|
400 | Bad Request | Invalid parameter values |
401 | Unauthorized | Missing/invalid API key |
403 | Forbidden | Access denied to resource |
422 | Unprocessable Entity | Invalid VIN or failed decoding |
429 | Too Many Requests | Rate limit exceeded |
500 | Internal Server Error | Temporary server issues |
502 | Bad Gateway | Issues with upstream services |
503 | Service Unavailable | API maintenance or downtime |
Use the NeoVIN Decoder to get detailed vehicle specifications including options packages, installed equipment, and features. This is ideal for applications requiring complete vehicle information.
Example:
Here we're performing a comprehensive NeoVIN decode to get detailed specifications:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/decode/car/neovin/WA1BBAFY7P2183119/specs',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
Includes available options details in NeoVIN responses.
Example:
Here we're requesting NeoVIN decode with available options details included:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/decode/car/neovin/1FTEW1C59LKE56394/specs',
params: {api_key: 'YOUR_API_KEY', include_available_options: 'true'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
Include generic specifications as fallback data when detailed decoding might not be available. This ensures you always get some vehicle information.
Example:
Here we're requesting NeoVIN decode with generic specifications included:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/decode/car/neovin/5TFUW5F16KX782196/specs',
params: {api_key: 'YOUR_API_KEY', include_generic: 'true'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
Retrieve detailed information about installed options, features, and equipment for vehicle valuation and configuration analysis.
Example:
Here we're focusing on options and features data from NeoVIN:
import axios from 'axios';
const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/decode/car/neovin/5TFVC5DB1NX010363/specs',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}