Decode Vehicle by VIN

Resolve a 17-character VIN to a normalized vehicle record with electrification fields and technical details.

GET /api/v1/vin/decode

Use this endpoint when you have a VIN and need the core ARC vehicle payload for downstream analytics, validation, or enrichment.

Authentication

Include X-API-Key on every request. Public API access is server-to-server only.

Caching

Successful VIN decode responses are returned with Cache-Control: public, max-age=86400.

Query Parameters

Field	Type	Description
vin	string	Required. The 17-character Vehicle Identification Number to decode.

Example Request

cURL

curl "https://api.autoresourceco.com/api/v1/vin/decode?vin=5YJ3E1EA1KF123456" \
  -H "X-API-Key: your_api_key_here"

Response Example

JSON

{
  "VIN": "1n4az1bv3nc561510",
  "Year": 2022,
  "Make": "NISSAN",
  "Model": "Leaf",
  "Trim": "S",
  "ElectrificationLevel": "BEV",
  "technical_details": {
    "body_class": "Hatchback/Liftback/Notchback",
    "vehicle_type": "PASSENGER CAR",
    "drive_type": "4x2",
    "fuel_type_primary": "Electric",
    "fuel_type_secondary": null,
    "series": null,
    "ev_drive_unit": null,
    "battery_type": null,
    "battery_energy_kwh_from": null,
    "battery_energy_kwh_to": null,
    "battery_voltage_from": null,
    "battery_voltage_to": null,
    "battery_modules_per_pack": null,
    "battery_cells_per_module": null,
    "charger_level": null,
    "charger_power_kw": "40",
    "wheel_base_inches": null,
    "curb_weight_lbs": null,
    "gvwr": "Class 1: 6,000 lb or less (2,722 kg or less)",
    "track_width_inches": null,
    "engine_configuration": null,
    "engine_cylinders": null,
    "displacement_l": null,
    "transmission_style": "Continuously Variable Transmission (CVT)",
    "air_bag_locations": null,
    "manufacturer_id": null,
    "plant_city": "SMYRNA",
    "plant_country": "UNITED STATES (USA)",
    "plant_company_name": "Nissan North America Inc."
  }
}

Response Fields

Field	Type	Description
VIN	string	Normalized VIN returned after validation and upstream decode.
Year	integer	Resolved model year for the decoded vehicle.
Make / Model / Trim	string	Human-readable vehicle identity fields returned by the decode provider.
ElectrificationLevel	string \| null	ARC classification for electrification such as BEV, PHEV, HEV, or FCEV.
technical_details	object	Expanded vehicle specifications including body, drivetrain, and plant metadata.

Related Docs

Authentication Errors and Limits