Documentation

Everything you need to integrate VIN intelligence into your stack.

Introduction

The Automotive Resource Co. API provides developers with granular, factory-level data for vehicle identification numbers (VINs). Unlike standard decoders, our resolution engine prioritizes electrification data, giving you instant access to battery capacity, voltage architecture, and charging speeds.

Coverage

Our database covers North American with additional models from European, and Asian markets for models 1981-Present.

Authentication

Authenticate your requests by including your secret API key in the X-API-Key header.

Bash

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

Never share your API keys. Rotate them immediately if compromised via your dashboard.

Decode VIN

Resolves a 17-character VIN to a normalized vehicle object with enhanced EV specifications.

GET https://api.autoresourceco.com/api/v1/vin/decode

Query Parameters

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

Response Example

	{
  "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."
  }
}

Batch Decode VINs

Efficiently decode multiple VINs in a single request. Perfect for bulk processing and reducing API calls. Each successful decode is billed separately, and partial failures are handled gracefully.

POST https://api.autoresourceco.com/api/v1/vin/decode-batch

Request Body

Field	Type	Description
vins	string[]	Required. Array of 17-character Vehicle Identification Numbers. Maximum 50 VINs per request.
years	number[]	Optional. Array of model years corresponding to each VIN. Must match the length of the vins array.

Request Example

JSON

	{
  "vins": [
    "5YJ3E1EA1KF123456",
    "JTDKB20U487780573",
    "1HGCM82633A123456"
  ],
  "years": [2023, 2008, 2003]
}

Response Example

	{
  "results": [
    {
      "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": "",
        "series": "",
        "ev_drive_unit": "",
        "battery_type": "",
        "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": "",
        "charger_power_kw": null,
        "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": "",
        "engine_cylinders": "",
        "displacement_l": "",
        "transmission_style": "Continuously Variable Transmission (CVT)",
        "air_bag_locations": null,
        "manufacturer_id": "997",
        "plant_city": "SMYRNA",
        "plant_country": "UNITED STATES (USA)",
        "plant_company_name": "Nissan North America Inc."
      }
    }
  ],
  "errors": [],
  "summary": {
    "total": 1,
    "successful": 1,
    "failed": 0
  }
}

Billing Information

Each successful VIN decode in the batch is billed as a separate API call. Failed decodes (due to invalid VINs or API errors) are not billed but are logged for usage tracking. The maximum batch size is 50 VINs per request.