API Plan Required

API Documentation

RESTful JSON API for programmatic VIN decoding. Integrate vehicle data into your apps, tools, or workflows.

Authentication

Include your API key in the Authorization header with every request.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://duckdecode.com/api/v1/decode?vin=1HGCM82633A004352

Decode a Single VIN

GET/api/v1/decode?vin={VIN}

Parameters

Param	Type	Description
vin	string	17-character Vehicle Identification Number

Example Response

{
  "result": {
    "vin": "1HGCM82633A004352",
    "year": "2003",
    "make": "HONDA",
    "model": "Accord",
    "trim": "EX",
    "vehicleType": "PASSENGER CAR",
    "bodyClass": "Sedan/Saloon",
    "driveType": "FWD",
    "fuelType": "Gasoline",
    "engineCylinders": "4",
    "engineDisplacement": "2.4",
    "engineHP": "160",
    "transmission": "Automatic",
    "doors": "4",
    "manufacturer": "HONDA MFG., INC.",
    "plantCountry": "UNITED STATES",
    "abs": "Standard",
    "esc": "Standard",
    "tpms": "Direct",
    "airBags": "1st Row (Driver and Passenger)"
  }
}

Batch Decode

POST/api/v1/decode/batch

Request Body

{
  "vins": [
    "1HGCM82633A004352",
    "5YJSA1DN5DFP14705",
    "1FTFW1ET5DFC10312"
  ]
}

Response

{
  "results": [ ... ],
  "count": 3
}

Maximum 50 VINs per batch request. Each VIN counts as one API call toward your monthly quota.

Rate Limits

Plan	Monthly Calls	Rate Limit
API	10,000	60 req/min
Enterprise	Custom	Custom

Error Codes

Code	Meaning
400	Invalid VIN format
401	Missing or invalid API key
422	VIN could not be decoded
429	Rate limit exceeded
500	Internal server error

Ready to integrate?

Get your API key and start decoding VINs in minutes.

Get API Access — $29/mo