Explorer Decode by VIN

Decode a VIN and return the vehicle payload plus minimal battery attributes for chemistry and compliance workflows.

GET /api/v1/explorer/vehicle/by-vin

Use this endpoint when you want a single request that combines vehicle decode output with ARC Explorer battery attributes.

Authentication

Include X-API-Key on every request. Explorer usage is billed separately from VIN decode usage.

Rate-limit headers

Successful Explorer responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

Query Parameters

Field	Type	Description
vin	string	Required. The 17-character VIN to validate, decode, and enrich with Explorer battery data.

Example Request

cURL

curl "https://api.autoresourceco.com/api/v1/explorer/vehicle/by-vin?vin=KMHC65LD3JU076468" \
  -H "X-API-Key: your_api_key_here"

Response Example

JSON

{
  "query": {
    "mode": "vin",
    "vin": "kmhc65ld3ju076468"
  },
  "vehicle": {
    "VIN": "kmhc65ld3ju076468",
    "Year": 2018,
    "Make": "HYUNDAI",
    "Model": "Ioniq",
    "Trim": "Plug-in-Hybrid (PHEV)",
    "ElectrificationLevel": "PHEV",
    "technical_details": {
      "body_class": "Hatchback/Liftback/Notchback",
      "vehicle_type": "PASSENGER CAR",
      "drive_type": null,
      "fuel_type_primary": "Electric",
      "fuel_type_secondary": "Gasoline",
      "series": null,
      "ev_drive_unit": null,
      "battery_type": "Lithium-Ion/Li-Ion",
      "battery_energy_kwh_from": null,
      "battery_energy_kwh_to": null,
      "battery_voltage_from": "360",
      "battery_voltage_to": null,
      "battery_modules_per_pack": null,
      "battery_cells_per_module": null,
      "charger_level": null,
      "charger_power_kw": "45",
      "wheel_base_inches": "106.30",
      "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": "4",
      "displacement_l": "1.6",
      "transmission_style": null,
      "air_bag_locations": null,
      "manufacturer_id": null,
      "plant_city": "ULSAN",
      "plant_country": "SOUTH KOREA",
      "plant_company_name": null
    }
  },
  "batteries": [
    {
      "cathode_chemistry": "NMC",
      "chemistry_group": "Lithium-Ion",
      "dot_hazard_class": "Hazardous",
      "energy_kwh": 8.9
    }
  ],
  "result_count": 1
}

Response Fields

Field	Type	Description
query	object	Normalized request context, including mode: vin and the validated VIN.
vehicle	object	Decoded vehicle payload in the same core shape as GET /api/v1/vin/decode.
batteries	object[]	Minimal battery objects with cathode_chemistry, chemistry_group, dot_hazard_class, and energy_kwh.
result_count	integer	Number of battery records returned in batteries.

Related Docs

Authentication Errors and Limits