Explorer Lookup by Year/Make/Model

Retrieve Explorer battery candidates when VINs are unavailable and you only know year, make, and model.

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

Use YMM lookup for intake flows, spreadsheets, and bulk workflows where vehicle records do not include VINs.

Authentication

Include X-API-Key on every request. YMM lookup uses the same rate-limit header contract as Explorer by VIN.

Idempotency

Include an Idempotency-Key with every request. Use a unique value for each logical request, and reuse the same value only when retrying that exact request. Use a new key when any input changes.

Variant handling

When electrification_level is omitted, ARC can return multiple battery candidates across BEV, HEV, or PHEV variants.

Query Parameters

Field	Type	Description
year	integer	Required. Vehicle model year. Valid range: 1886-2100.
make	string	Required. Vehicle make. Input is trimmed before lookup.
model	string	Required. Vehicle model. Input is trimmed before lookup.
electrification_level	string	Optional. Optional ranking preference such as BEV, PHEV, or HEV. Leave unset to return broader candidate sets.

Example Variants

Leave electrification_level unset when the intake record only includes year, make, and model. ARC returns broader candidate coverage across plausible variants.

Example Request

cURL

curl "https://api.autoresourceco.com/api/v1/explorer/vehicle/by-ymm?year=2018&make=Hyundai&model=Ioniq" \
  -H "X-API-Key: your_api_key_here" \
  -H "Idempotency-Key: explorer-ymm-example-001"

Response Example

JSON

{
  "query": {
    "mode": "ymm",
    "year": 2018,
    "make": "Hyundai",
    "model": "Ioniq",
    "electrification_level": null
  },
  "vehicle": {
    "VIN": null,
    "Year": 2018,
    "Make": "Hyundai",
    "Model": "Ioniq",
    "Trim": null,
    "ElectrificationLevel": null,
    "technical_details": null
  },
  "batteries": [
    {
      "cathode_chemistry": "NMC",
      "chemistry_group": "Lithium-Ion",
      "dot_hazard_class": "Hazardous",
      "energy_kwh": 1.56,
      "weight_lbs": 85
    },
    {
      "cathode_chemistry": "NMC",
      "chemistry_group": "Lithium-Ion",
      "dot_hazard_class": "Hazardous",
      "energy_kwh": 28,
      "weight_lbs": 599
    },
    {
      "cathode_chemistry": "NMC",
      "chemistry_group": "Lithium-Ion",
      "dot_hazard_class": "Hazardous",
      "energy_kwh": 8.9,
      "weight_lbs": 258
    }
  ],
  "result_count": 3
}

Response Fields

Field	Type	Description
query	object	Normalized YMM request context, including any provided electrification preference.
vehicle	object	Synthetic vehicle summary reflecting the requested year, make, model, and electrification level.
batteries	object[]	Minimal battery candidates with cathode_chemistry, chemistry_group, dot_hazard_class, energy_kwh, and weight_lbs.
batteries[].weight_lbs	number \| null	Complete battery pack weight in pounds. Null when ARC does not have a usable canonical pack weight.
result_count	integer	Number of battery candidates returned.

Related Docs

Authentication Errors and Limits