API URL
POST /decode
Headers
Code
Content-Type: application/jsonBody Parameters
Param
Type
Description
vin
required
string
17-character VIN to decode (if single mode)
prefix
required
array
VIN prefix for suggestions (3-9 characters, for /suggest/:prefix endpoint)
Example Request
Code
{
"vin": "1HGCM82633A004352"
}Successful Response
Status
HTML
200 OKBody
Code
{
"vin": "1HGCM82633A004352",
"make": "HONDA",
"model": "Accord",
"year": "2003"
}Field
Type
Description
vin
string
17-character vehicle identification number decoded for automotive business intelligence
make
string
Vehicle manufacturer brand name for inventory categorization and market analysis
model
string
Specific vehicle model designation for accurate parts identification and valuation
year
string
Manufacturing year for depreciation calculations and regulatory compliance tracking
trim
string
Vehicle trim level and feature package for pricing analysis and customer targeting
engine
string
Engine specifications including displacement and configuration for performance assessment
drivetrain
string
Power delivery system (FWD, RWD, AWD) affecting vehicle capability and market positioning
body_type
string
Vehicle category classification for insurance underwriting and market segmentation
manufacturer
string
Assembly plant operator for supply chain tracking and quality assessment
plant_country
string
Manufacturing country for trade compliance and origin verification
vehicle_type
string
NHTSA safety classification for regulatory compliance and insurance categorization
Error Response
Example
Code
400 INVALID_INPUT – If input fields are missing or malformed
400 INVALID_CHECKSUM – If VIN fails ISO 3779 checksum
500 NHTSA_ERROR – If NHTSA service fails or returns errorLast Updated: May 4, 2026