NeoVIN Decoder

Enhanced VIN decoder providing comprehensive vehicle specifications and attributes from a 17-character VIN, including options, features, and installed equipment.

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.

Base Path

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:

request.js
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);
}

Request

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.

Parameters

Available parameters for enhanced VIN decoding requests:

3 Params
api_key
string required

Your MarketCheck API authentication key. Required for every request, unless OAuth is used.

include_generic
boolean

If true, includes generic VIN decode information in NeoVIN responses.

include_available_options
boolean

If true, includes available options details in NeoVIN responses.

Required Parameters

The following parameters are required for NeoVIN decoding requests:

  • vin - The 17-character VIN of the vehicle to decode (provided in URL path)
    • Case-insensitive string that must be properly formatted
    • Must be provided as a path parameter in the URL structure
    • Squish VIN is not supported in this API

Special Parameters

include_generic

  • Use include_generic=true to include additional generic specifications alongside detailed NeoVIN data
  • When VIN decoding fails but generic specifications are available, they will be included automatically
  • Provides fallback data when comprehensive decoding is not possible

include_available_options

  • Use include_available_options=true to include available options details alongside detailed NeoVIN data
  • Provides factory-available options and packages for the decoded VIN

Response

The NeoVIN Decoder API returns comprehensive vehicle specifications and detailed information in a structured JSON format.

Schema

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
}

Success Response

  • 200 OK - Returns a JSON object containing detailed vehicle specifications derived from the VIN
    • Includes comprehensive details such as year, make, model, trim, body type, and extensive additional data
    • Contains options packages, installed equipment, features, and high-value features
    • Provides confidence scores for various decoded attributes
    • If include_generic=true, includes generic specifications alongside detailed data
    • If include_available_options=true includes available options details alongside detailed NeoVIN data

Error Response

Status CodeDescriptionCommon Causes
400Bad RequestInvalid parameter values
401UnauthorizedMissing/invalid API key
403ForbiddenAccess denied to resource
422Unprocessable EntityInvalid VIN or failed decoding
429Too Many RequestsRate limit exceeded
500Internal Server ErrorTemporary server issues
502Bad GatewayIssues with upstream services
503Service UnavailableAPI maintenance or downtime

Use Cases & Examples

Comprehensive VIN Decode

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:

request.js
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);
}

VIN Decode with Available Options

Includes available options details in NeoVIN responses.

Example:

Here we're requesting NeoVIN decode with available options details included:

request.js
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);
}

VIN Decode with Generic Fallback

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:

request.js
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);
}

Options and Features Analysis

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:

request.js
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);
}

See Also