Data Definitions

This guide provides detailed definitions of all fields in the NeoVIN dataset. Understanding these fields is essential for developers and analysts to effectively use our vehicle decoding data feeds and APIs.

Field Definitions

vin

The Vehicle Identification Number (VIN) is a unique 17-character alphanumeric code assigned to every vehicle by the manufacturer. VIN is used as the unique primary key for this dataset.

Source: Input - Provided as input for vehicle decoding.

API Parameters

• vin - Input parameter for decoding specific VIN

See Also

• squish_vin - VIN prefix identification

squish_vin

VIN prefix identification used in the decoding of the vehicle. This represents a compressed or normalized version of the VIN that helps in pattern matching and decoding processes.

Source: Generated - Derived from the input VIN during processing.

See Also

• vin - Full VIN information

year

Represents the model year of the vehicle, as designated by the manufacturer. The model year reflects the version or release cycle of the vehicle and may differ from the actual production date. It is essential for identifying vehicle generation, design updates, features, and compliance with regulatory standards.

Source: Derived using the decode procedure.

See Also

• make - Manufacturer information
• model - Vehicle model details

make

Specifies the manufacturer or brand of the vehicle. The make represents the company that produces the vehicle and is often the first element in identifying a car. This field is essential for categorizing and filtering vehicle listings.

Source: Derived using the decode procedure.

See Also

• model - Vehicle model information
• year - Model year details

model

Indicates the specific product line or series of a vehicle produced by a manufacturer (make). The model differentiates vehicles within a brand and typically reflects design, size, and intended use. It is used in combination with the make to uniquely identify a vehicle offering.

Source: Derived using the decode procedure.

See Also

• make - Manufacturer information
• trim - Vehicle trim level details

country

The country where the vehicle was manufactured or primarily marketed, as identified through VIN decoding. This information helps understand market-specific specifications and regulatory compliance.

Source: Derived using the decode procedure.

See Also

• make - Manufacturer information

vehicle_type

Defines the general classification or category of the vehicle based on its design, structure, and intended use. The vehicle_type helps group vehicles into recognizable segments for consumers and is commonly used for filtering, comparison, and analytics.

Source: Derived using the decode procedure.

See Also

• body_type - Body type information
• make - Manufacturer information

Vehicle Configuration & Specifications

trim

Specifies the variant or configuration level of a particular vehicle model, often indicating different sets of features, equipment, styling, or performance options. The trim helps differentiate versions of the same model by offering varying levels of luxury, technology, and functionality.

Source: Derived using the decode procedure.

See Also

• trim_confidence - Trim identification confidence
• version - Version details

trim_confidence

Identification of confidence related to the selection of the trim. This field indicates how certain the decoding process is about the identified trim level, which can help users assess data reliability.

Source: Generated - Calculated during the VIN decoding process.

See Also

• trim - Trim information
• version_confidence - Version confidence details

version

Version Name of the vehicle, representing a more specific identification than trim. The version provides detailed sub-classification within a trim level, often including specific equipment packages or manufacturing variations.

Source: Derived using the decode procedure.

See Also

• version_confidence - Version identification confidence
• trim - Trim information

version_confidence

Identification of confidence related to the selection of the vehicle version. This indicates the reliability level of the version identification process.

Source: Generated - Calculated during the VIN decoding process.

See Also

• version - Version information
• listing_confidence - Listing confidence details

listing_confidence

Identification of primary source data used for options. This field indicates the data source that provided the most reliable information for the vehicle's installed options.

Source: Generated - Determined during the data processing and enrichment phase.

See Also

• trim_confidence - Trim confidence information
• version_confidence - Version confidence information

Powertrain & Performance

transmission

Describes the type of gearbox system used in the vehicle that controls how power is transferred from the engine to the wheels. The transmission impacts the driving experience, fuel efficiency, and performance of the vehicle.

Source: Derived using the decode procedure.

See Also

• transmission_confidence - Transmission identification confidence
• transmission_description - Detailed transmission description

transmission_confidence

Identification of confidence related to the selection of the installed transmission. This field provides insight into how accurately the transmission type was identified during the decoding process.

Source: Generated - Calculated during the VIN decoding process.

See Also

• transmission - Transmission information
• transmission_description - Transmission description

transmission_description

The detailed description of the installed transmission, providing more comprehensive information about the transmission characteristics and features beyond the basic type.

Source: Derived using the decode procedure.

See Also

• transmission - Basic transmission type
• transmission_confidence - Transmission confidence

drivetrain

Specifies the drive system configuration of a vehicle, indicating how power from the engine or motor is transmitted to the wheels. The drivetrain affects performance, traction, fuel efficiency, and handling, making it an important attribute for vehicle classification and comparison.

Source: Derived using the decode procedure.

See Also

• transmission - Transmission type
• engine - Engine specifications

engine

Base identification of the number of cylinders and configuration of the installed engine on the vehicle. The engine field helps identify performance characteristics such as power output, efficiency, and suitability for different driving needs.

Source: Derived using the decode procedure.

See Also

• cylinders - Number of cylinders
• engine_type - Engine configuration type
• engine_displacement - Engine displacement

cylinders

Indicates the number of cylinders in the vehicle's engine. This value directly relates to engine performance, fuel efficiency, and vehicle classification.

Source: Derived using the decode procedure.

See Also

• engine - Engine information
• engine_type - Engine configuration

engine_type

Type of the engine configuration, indicating the arrangement of cylinders in the engine block. Common types include V (V-configuration), I (Inline), H (Horizontally opposed), etc.

Source: Derived using the decode procedure.

See Also

• engine - Engine information
• cylinders - Number of cylinders

engine_displacement

The measure of the cylinder volume swept by all of the pistons of a piston engine, excluding the combustion chambers (measured in Liters). Engine displacement often correlates with engine power and fuel efficiency.

Source: Derived using the decode procedure.

See Also

• engine - Engine information
• cylinders - Number of cylinders

fuel_type

Indicates the type of fuel or energy source the vehicle uses to power its engine. The fuel_type affects vehicle performance, emissions, range, and operating cost. It is a key field for consumers evaluating environmental impact and fuel efficiency.

Source: Derived using the decode procedure.

See Also

• powertrain_type - Powertrain type information
• engine - Engine information

powertrain_type

Defines the installed propulsion/fuel type of the vehicle, such as Combustion/Hybrid/Battery Electric, etc. This classification helps identify the primary energy source and propulsion technology used by the vehicle.

Source: Derived using the decode procedure.

See Also

• fuel_type - Fuel type information
• drivetrain - Drive system configuration

Physical Dimensions & Capacity

doors

The number of doors on the vehicle, typically including front and rear passenger doors, and sometimes the hatch or tailgate in hatchbacks and SUVs.

Source: Derived using the decode procedure.

See Also

• body_type - Body type information

body_type

Describes the physical structure and exterior shape of the vehicle, typically reflecting its size, number of doors, roofline, and cargo area design. The body_type is more specific than vehicle_type and helps define the vehicle's intended functionality and style.

Source: Derived using the decode procedure.

See Also

• body_subtype - Body subtype information
• vehicle_type - Vehicle type classification

body_subtype

Body subtype (cab) of the vehicle, providing additional classification details beyond the main body type. This field offers more granular categorization, particularly useful for trucks and specialized vehicles.

Source: Derived using the decode procedure.

See Also

• body_type - Main body type information

weight

Gross vehicle weight rating (GVWR) of the vehicle, measured in pounds. This represents the maximum total weight of the vehicle including passengers, cargo, and fluids when fully loaded.

Source: Derived using the decode procedure.

See Also

• length - Vehicle length
• width - Vehicle width
• height - Vehicle height

width

Overall width of the vehicle measured in inches, including mirrors and other external components. This dimension is important for parking considerations and regulatory compliance.

Source: Derived using the decode procedure.

See Also

• length - Vehicle length
• height - Vehicle height

height

Overall height of the vehicle measured in inches from the ground to the highest point of the vehicle. This measurement is crucial for clearance considerations such as parking garages and bridges.

Source: Derived using the decode procedure.

See Also

• length - Vehicle length
• width - Vehicle width

length

Overall length of the vehicle measured in inches from front bumper to rear bumper. This dimension affects parking requirements and cargo capacity considerations.

Source: Derived using the decode procedure.

See Also

• width - Vehicle width
• height - Vehicle height

seating_capacity

Identified seating capacity of the vehicle, indicating the maximum number of passengers the vehicle is designed to accommodate safely and legally.

Source: Derived using the decode procedure.

See Also

• doors - Number of doors
• body_type - Body type information

Fuel Economy

city_mpg

Represents the estimated fuel efficiency of the vehicle in miles per gallon (MPG) during city driving conditions, as determined by regulatory agencies.

Source: Derived using the decode procedure.

See Also

• highway_mpg - Highway fuel efficiency
• fuel_type - Fuel type information

highway_mpg

Represents the estimated fuel efficiency of the vehicle in miles per gallon (MPG) under highway driving conditions, as determined by regulatory agencies.

Source: Derived using the decode procedure.

See Also

• city_mpg - City fuel efficiency
• fuel_type - Fuel type information

Manufacturer Codes & Pricing

manufacturer_code

Manufacturer code of the vehicle, representing internal manufacturing identifiers used by the automaker for production tracking and parts identification. This code helps identify specific manufacturing specifications and production details.

Source: Derived using the decode procedure.

See Also

• package_code - Package code information
• version - Version details

package_code

Extracted manufacturer package code related to selection of the vehicle version (where available/applicable). This code identifies specific equipment packages or option bundles offered by the manufacturer.

Source: Derived using the decode procedure.

See Also

• package_description - Package description
• manufacturer_code - Manufacturer code information

package_description

Extracted manufacturer package code description (where available/applicable). This provides human-readable description of what the package code represents in terms of features and equipment.

Source: Derived using the decode procedure.

See Also

• package_code - Package code information
• installed_options_details - Detailed options information

Pricing Information

msrp

Base MSRP (Manufacturer's Suggested Retail Price) as defined for the defined version of that vehicle with no options installed. This represents the starting price for the vehicle before any additional equipment or packages.

Source: Enriched - Derived from manufacturer specifications and VIN decoding.

See Also

• combined_msrp - Total MSRP with options
• installed_options_msrp - Options MSRP

delivery_charges

Manufacturer defined delivery charges, also known as destination fees. These are mandatory fees charged by the manufacturer to cover the cost of transporting the vehicle from the manufacturing facility to the dealership.

Source: Enriched - Derived from manufacturer specifications.

See Also

• msrp - Base MSRP information
• combined_msrp - Total MSRP including delivery

installed_options_msrp

Calculated combination of the MSRP for the installed options and packages. This represents the total additional cost of all factory-installed options and equipment packages beyond the base vehicle price.

Source: Generated - Calculated from identified installed options and their respective MSRPs.

See Also

• installed_options_details - Detailed options information
• combined_msrp - Total MSRP

combined_msrp

The total manufacturer's suggested retail price for the vehicle as configured, derived from base MSRP, delivery charges, installed options MSRP, and applicable discounts and taxes.

Source: Generated - Calculated by combining base MSRP, delivery charges, installed options MSRP, discounts & taxes.

See Also

• msrp - Base MSRP information
• delivery_charges - Delivery charges
• installed_options_msrp - Options MSRP

Colors

interior_color

The manufacturer defined option code and name for the interior color of the vehicle. This field provides structured information about the vehicle's interior color specification as defined by the manufacturer.

Source: Enriched - Derived from the VIN using the decoder and manufacturer specifications.

See Also

• exterior_color - Exterior color information
• Color Objects - Detailed color object structure

exterior_color

The manufacturer defined option code and name for the exterior color of the vehicle. This field includes pricing information when the exterior color is an optional feature that affects the vehicle's MSRP.

Source: Enriched - Derived from the VIN using the decoder and manufacturer specifications.

See Also

• interior_color - Interior color information
• Color Objects - Detailed color object structure

Options & Features

options_packages

Option and package codes installed on the vehicle, represented as a comma-separated list. These codes identify specific manufacturer options and packages that were factory-installed on the vehicle.

Source: Enriched - Derived from the VIN using the decoder and manufacturer specifications.

See Also

• installed_options_details - Detailed options information
• package_code - Package code information

installed_options_details

Listing of all identified installed options with comprehensive details. This structured data provides complete information about each option including pricing, confidence levels, and verification status.

Source: Enriched - Derived from the VIN using the decoder and manufacturer specifications.

See Also

• options_packages - Option codes summary
• installed_options_msrp - Options pricing
• Installed Options Details - Detailed structure information

Features & Equipment

features

Normalized feature set of equipment that have been identified as installed on the vehicle, including whether that item was standard to the version of the vehicle or was added as an installed option. These are organized under their respective option codes or under the STANDARD key for base equipment.

Source: Enriched - Derived from the VIN using the decoder and manufacturer specifications.

See Also

• installed_equipment - Detailed equipment information
• high_value_features - High value features subset
• Features Structure - Detailed structure information

installed_equipment

Detailed equipment identified as installed on the vehicle, including whether that item was standard to the version of the vehicle or was added as an installed option. This provides granular details about specific equipment attributes and values.

Source: Enriched - Derived from the VIN using the decoder and manufacturer specifications.

See Also

• features - Normalized features information
• high_value_features - High value features subset
• Installed Equipment Structure - Detailed structure information

high_value_features

High value features is a subset of features, highlighting the most significant and valuable equipment and options installed on the vehicle. These features are typically those that substantially impact the vehicle's value, functionality, or desirability.

Source: Enriched - Derived from the VIN using the decoder and manufacturer specifications.

See Also

• features - Complete features information
• installed_equipment - Detailed equipment information
• High Value Features Structure - Detailed structure information

System Information

delivery_date

Delivery date for the records, indicating when the decoded data was processed and made available. This field is important for data warehouse operations and tracking data freshness.

Source: Generated - System-assigned during data processing.

See Also

• decode_version - Decode version information

decode_version

This field represents version tracking for VIN decode values, indicating if previous decode results have been updated. Higher versions indicate more recent or improved decoding results for the same VIN.

Source: Generated - System-assigned during data processing and updates.

See Also

• delivery_date - Data delivery information
• observation - Decode status information

observation

Reason why decode is not available or status information about the decoding process. This field provides insight into any limitations or special conditions that affected the VIN decoding process.

Source: Generated - System-assigned based on decoding process results.

See Also

• decode_version - Decode version information

Warranty Information

warranty

Manufacturer warranty information associated with the vehicle, providing details about the coverage available from the manufacturer. This information helps consumers and dealers understand the warranty status and coverage terms for the decoded vehicle.

Source: Enriched - Derived from manufacturer specifications based on year, make and model etc.

See Also

• make - Manufacturer information
• model - Vehicle model information

MSRP Variants by Source

The following fields highlights MSRP values from different data source, enabling comparison and reconciliation across data sources. The combined_msrp field represents the vehicle's final MSRP, while these fields preserve the source-specific values for transparency and auditability.

original_msrp

The Original MSRP value represents the MSRP captured from Marketcheck listings data when the vehicle was first listed as New and initially detected by Marketcheck.

Source: Enriched - Web scraped by Marketcheck crawlers.

See Also

• msrp - Selected MSRP information
• msrp_label - MSRP source label

build_specs_msrp

MSRP value sourced from MarketCheck Window Stickers data. This represents the MSRP as determined from the window stickers database and is often used as a reference value during Combined MSRP reconciliation. This represents the manufacturer's authoritative MSRP and is typically the most reliable source when available.

Source: Enriched - Derived from MarketCheck Window Stickers data.

See Also

• msrp - Selected MSRP information
• oem_msrp - OEM MSRP value

oem_msrp

MSRP value as scraped directly from the OEM (Original Equipment Manufacturer) websites. This represents the manufacturer's authoritative MSRP and is typically the second most reliable source when available. This is also often used as a reference value during Combined MSRP reconciliation when the build_specs_msrp is not available.

Source: Enriched - Derived from OEM-provided data.

See Also

• msrp - Selected MSRP information
• build_specs_msrp - Build specs MSRP value

mc_msrp

This represents MarketCheck's best estimate of the MSRP based on aggregating and validating multiple data sources.

Source: Generated - Calculated by MarketCheck reconciliation logic.

See Also

• msrp - Selected MSRP information
• msrp_label - MSRP source label

msrp_label

Indicates which source was selected by MarketCheck's reconciliation logic to populate the mc_msrp field. This helps users understand the provenance of MarketCheck's best-estimate MSRP and assess its reliability based on the contributing source.

Source: Generated - Determined during MSRP reconciliation processing.

See Also

• msrp - Selected MSRP information
• record_source - Record source information

Discounts & Taxes

Information about discounts and taxes applicable to the vehicle, used to compute the final pricing.

discounts

Array of discount entries applicable to the vehicle, with each entry describing a specific discount type and amount. Discounts may include manufacturer rebates or special package/equipment discounts.

Source: Enriched - Derived & reconciled using window stickers and specifications provider's data.

See Also

• total_discount - Total discount amount
• taxes - Tax information

total_discount

The total monetary value of all discounts applied to the vehicle, computed by summing the individual entries in the discounts array. The values are always represented as positive numbers; however, they indicate discounts that should be subtracted from the combined MSRP during reconciliation.

Source: Generated - Calculated from the discounts array.

See Also

• discounts - Detailed discount information
• total_tax - Total tax amount

taxes

Array of tax entries applicable to the vehicle, with each entry describing a specific tax type and amount. Taxes may include Federal tax, Green tax or other regulatory charges.

Source: Enriched - Derived & reconciled using window stickers and specifications provider's data.

See Also

• total_tax - Total tax amount
• discounts - Discount information

total_tax

The total monetary value of all taxes applied to the vehicle, computed by summing the individual entries in the taxes array.

Source: Generated - Calculated from the taxes array.

See Also

• taxes - Detailed tax information
• total_discount - Total discount amount

Record Source & Confidence

record_source

Identifies the primary data source used to generate the decoded record. This field helps users understand the provenance of the record and assess data reliability based on source quality.

Source: Generated - Assigned during record processing based on the contributing source.

The following table describes the possible values of record_source, the criteria used to assign each label, and the corresponding data quality indicator:

See Also

• record_confidence - Record confidence information
• listing_confidence - Listing confidence information

record_confidence

Confidence level assigned to the overall decoded record, indicating the reliability of the decoded information. Higher confidence values indicate stronger source agreement and more reliable decoded data.

Source: Generated - Calculated based on source agreement and decoding signals.

How record_confidence is Calculated

The score is derived from how closely the combined_msrp aligns with reference MSRP values (build_specs_msrp, oem_msrp, original_msrp). The final value is max(0, 100 - penalty).

Special cases (evaluated before the penalty rules):

• Returns nil when no reference_msrp is available for comparison.
• Returns 100 when combined_msrp exactly matches build_specs_msrp, oem_msrp, or original_msrp; or when the record is marked as Build Verified (e.g., Build Verified Considering Discounts, Build Verified – Negative Options Match MSRP Diff, Build Verified – Extra Price Information Match MSRP Diff).
• Returns 0 when the record falls under unrecoverable categories — Missing MSRP Versions, Missing MFG Code Issues, or Base MSRP & MFG Code Record Avl But Not Picked.

Penalty-based scoring (when none of the special cases apply):

Additional penalty: An extra +10% penalty is applied when the version field contains a pipe character (|), indicating multiple candidate versions were identified and the version could not be uniquely resolved.

See Also

• record_source - Record source information
• listing_confidence - Listing confidence information

Understanding the Data Structure

JSON Object Fields

Several fields in NeoVIN return structured JSON objects containing detailed information:

Color Objects

Interior Color:

{
  "code": "A7X9",
  "name": "Black Cloth",
  "confidence": "1.0"
}

Exterior Color:

{
  "code": "PAU",
  "name": "Granite Crystal Metallic Clear Coat",
  "msrp": "0",
  "confidence": "1.0"
}

Installed Options Details

[
  {
    "code": "AHQ",
    "name": "Max Tow Package",
    "msrp": "495",
    "type": "P",
    "confidence": "High",
    "verified": null,
    "rule": "Unspecified",
    "sale_price": "495"
  },
  {
    "code": "DGJ",
    "name": "5-Speed Automatic Transmission",
    "msrp": "1400",
    "type": "O",
    "confidence": "High",
    "verified": null,
    "rule": "Unspecified",
    "sale_price": "1400"
  },
  {
    "code": "MX3",
    "name": "Black 3-Piece Hard Top",
    "msrp": "995",
    "type": "O",
    "confidence": "High",
    "verified": null,
    "rule": "Unspecified",
    "sale_price": "995"
  },
  {
    "code": "RC9",
    "name": "Alpine 9-Speaker w/All Weather Subwoofer",
    "msrp": "945",
    "type": "O",
    "confidence": "High",
    "verified": null,
    "rule": "Unspecified",
    "sale_price": "945"
  }
]

Features Structure

{
  "MX3": [
    {
      "category": "Comfort & Convenience",
      "feature_type": "Windshield Wipers",
      "description": "Rear Windshield Wipers"
    }
  ],
  "AHQ": [
    {
      "category": "Exterior",
      "feature_type": "Trailer",
      "description": "Trailer Hitch"
    }
  ],
  "RC9": [
    {
      "category": "Infotainment",
      "feature_type": "Audio Speakers",
      "description": "Premium Brand Speakers"
    }
  ],
  "DGJ": [
    {
      "category": "Transmission",
      "feature_type": "Transmission",
      "description": "Manual Mode"
    }
  ],
  "STANDARD": [
    {
      "category": "Comfort & Convenience",
      "feature_type": "Air Conditioning-Type",
      "description": "Manual Air Conditioning"
    }
  ]
}

Installed Equipment Structure

{
  "AHQ": [
    {
      "category": "Exterior",
      "item": "Trailer towing preparation",
      "attribute": "trailer hitch",
      "location": "",
      "value": "yes"
    }
  ],
  "DGJ": [
    {
      "category": "Transmission",
      "item": "Transmission",
      "attribute": "number of speeds",
      "location": "",
      "value": "5"
    }
  ],
  "MX3": [
    {
      "category": "Exterior",
      "item": "Convertible roof",
      "attribute": "color",
      "location": "hard",
      "value": "Black"
    }
  ],
  "RC9": [
    {
      "category": "Infotainment",
      "item": "Speakers",
      "attribute": "brand name",
      "location": "",
      "value": "Alpine"
    }
  ],
  "STANDARD": [
    {
      "category": "General",
      "item": "Model year",
      "attribute": "Model year",
      "location": "",
      "value": "2017"
    }
  ]
}

High Value Features Structure

{
  "MX3": [
    {
      "category": "Exterior",
      "description": "Convertible Roof"
    }
  ],
  "RC9": [
    {
      "category": "Infotainment",
      "description": "Premium Audio"
    }
  ],
  "DGJ": [
    {
      "category": "Transmission",
      "description": "Automatic Transmission"
    }
  ],
  "STANDARD": [
    {
      "category": "Comfort & Convenience",
      "description": "Keyless Entry/Locking"
    }
  ]
}

Data Categories

The features and equipment are organized into logical categories:

• Comfort & Convenience: Climate control, seating features, convenience items
• Exterior: Body features, lighting, exterior styling elements
• Infotainment: Audio systems, connectivity, entertainment features
• Transmission: Transmission type and related features
• Safety & Driver Assist: Safety systems and driver assistance features

This comprehensive data dictionary enables users to understand every aspect of the vehicle information provided by NeoVIN, from basic identification through detailed equipment specifications and pricing analysis.