Explorer Decode by VIN

Decode a VIN and return the vehicle payload plus minimal battery attributes. The response includes the most specific battery match available.

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 and returns a concise pack answer.

Authentication

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

What to expect for response time

Explorer by VIN adds battery enrichment on top of decode. Active lookups typically return in 250–550ms—about 400ms on average. The first request after idle may take longer while the pipeline warms up.

Rate-limit headers

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

Built for decisive workflows

The endpoint returns concise battery results so pricing, compliance, and logistics workflows can start with confidence instead of manual triage.

Query Parameters

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

Example Variants

When one battery matches the decoded vehicle, the batteries array contains that pack.

Example Request

cURL

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

Response Example

JSON

{
  "query": {
    "mode": "vin",
    "vin": "kmhc65ld4ju000001"
  },
  "vehicle": {
    "VIN": "kmhc65ld4ju000001",
    "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