Year, Make and Model API

Decode a VIN to its year, make, model, trim, style, body, engine, drive and transmission, with the VIN's validation details. For the full decode, with doors, fuel and the candidates of an ambiguous VIN, use VIN Decode.

Endpoint

GET https://api.auto.dev/ymm/{vin}

View in Browser

https://api.auto.dev/ymm/1FMCU0G60LUA05025

Parameters

Prop	Type	Default
`vin`	`string`	-

Example Request

curl -X GET "https://api.auto.dev/ymm/1FMCU0G60LUA05025" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Structure

Prop	Type	Default
`vin?`	`string`	-
`vinValid?`	`boolean`	-
`wmi?`	`string`	-
`origin?`	`string`	-
`squishVin?`	`string`	-
`checkDigit?`	`string`	-
`checksum?`	`boolean`	-
`type?`	`string`	-
`years?`	`number[]`	-
`year?`	`number`	-
`yearAmbiguous?`	`boolean`	-
`ambiguous?`	`boolean`	-
`make?`	`string`	-
`model?`	`string`	-
`trim?`	`string`	-
`style?`	`string`	-
`body?`	`string`	-
`engine?`	`string`	-
`drive?`	`string`	-
`transmission?`	`string`	-
`vehicle?`	`object`	-

Example Response

A 2020 Ford Escape, recorded 2026-11-12:

{
  "vin": "1FMCU0G60LUA05025",
  "vinValid": true,
  "wmi": "1FM",
  "origin": "United States",
  "squishVin": "1FMCU0G6LU",
  "checkDigit": "0",
  "checksum": true,
  "type": "MPV",
  "years": [2020],
  "year": 2020,
  "ambiguous": false,
  "make": "Ford",
  "model": "Escape",
  "trim": "SE FWD",
  "style": "1.5, 3 Cylinder Engine",
  "body": "4dr SUV",
  "engine": "1.5, 3 Cylinder Engine",
  "drive": "Front Wheel Drive",
  "transmission": "Automatic",
  "vehicle": {
    "vin": "1FMCU0G60LUA05025",
    "year": 2020,
    "make": "Ford",
    "model": "Escape",
    "manufacturer": "Ford Motor Company"
  }
}

Error Responses

Errors come wrapped in an error object. Every response also carries the api and user blocks, omitted from the examples below.

Invalid VIN

A malformed VIN answers 400 with code INVALID_VIN_FORMAT:

{
  "vinValid": false,
  "error": {
    "status": 400,
    "error": "VIN must be exactly 17 characters containing only letters and numbers (excluding I, O, Q)",
    "code": "INVALID_VIN_FORMAT",
    "path": "/ymm/12345",
    "requestId": "a5986c13d8fd3f0e"
  }
}

VIN Not Found

A VIN that cannot be decoded answers 404 with code VIN_NOT_FOUND ("Unable to decode VIN: …").

Interactive API Reference

Try Year, Make and Model API

Test this endpoint with your API key and explore live responses

Plan Availability

Free: ❌ Not available
Growth: ✅ Available
Scale: ✅ Available

See pricing for plan details and signup.

Year, Make and Model API

Try Year, Make and Model API

On this page