Decode VIN
Decode a 17-character Vehicle Identification Number (VIN) to retrieve comprehensive vehicle information including make, model, year, and validation details.
AuthorizationBearer <token>
Use your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY
In: header
Path Parameters
vinstring
17-character Vehicle Identification Number
Match
^[A-HJ-NPR-Z0-9]{17}$Query Parameters
ambiguity?boolean
Whether to allow a best-guess answer for a VIN that matches several styles. By default (false) the answer does not guess: style is null, trim is null unless our sources settle it (specs is null on /specs), and trims and styles list the possibilities. true allows a single best-guess pick. Also accepted as the X-Ambiguity header.
Default
falseResponse Body
curl -X GET "https://api.auto.dev/vin/string?ambiguity=false"{
"vin": "3GCUDHEL3NG668790",
"vinValid": true,
"wmi": "3GC",
"origin": "Mexico",
"squishVin": "3GCUDHELNG",
"checkDigit": "3",
"checksum": true,
"type": "Active",
"make": "Chevrolet",
"model": "Silverado 1500",
"trim": "ZR2",
"style": "4x4 4dr Crew Cab 5.8 ft. SB",
"body": "Truck",
"engine": "5.3L V8 OHV 16V FFV",
"drive": "4WD",
"transmission": "Automatic",
"vehicle": {
"vin": "3GCUDHEL3NG668790",
"year": 2022,
"make": "Chevrolet",
"model": "Silverado 1500",
"manufacturer": "General Motors de Mexico"
},
"ambiguous": false
}{
"vin": "1T9P61527VP394134",
"vinValid": true,
"vehicle": {
"vin": "1T9P61527VP394134",
"year": 2027,
"manufacturer": "The Metal Shop",
"type": "Utility Trailers"
},
"yearAmbiguous": true,
"years": [
2027,
1997
],
"reason": "class_not_covered",
"retryable": false
}{
"status": 400,
"error": "VIN must be exactly 17 characters containing only letters and numbers (excluding I, O, Q)",
"code": "INVALID_VIN_FORMAT",
"path": "/vin/123Invalid",
"requestId": "a1b2c3d4e5f6g7h8"
}{
"status": 404,
"error": "No vehicle data found for the provided VIN",
"code": "VIN_NOT_FOUND",
"path": "/vin/3GCUDHEL3NG668790",
"requestId": "b2c3d4e5f6g7h8i9"
}