Batch Decode Vehicles by VIN

Decode multiple VINs in one request and receive successful results plus per-VIN validation or upstream failures.

POST /api/v1/vin/decode-batch

Use batch decode for backfills, bulk imports, or queue workers that need to process multiple VINs while preserving partial success.

Authentication

Batch decode uses the same X-API-Key header contract as the single VIN endpoint.

What to expect for response time

Once warmed up, batch requests typically complete in under a second. The first batch after idle may take longer—often up to about 10 seconds—before throughput settles into the faster range.

Billing

Each successful VIN decode is billed individually. Invalid VINs and failed decodes are not billed.

Request Body

Field	Type	Description
vins	string[]	Required. Array of VINs to decode. Maximum 50 VINs per request.
years	number[]	Optional. Optional model years aligned to the input VIN array. Extra values are ignored if a VIN is invalid.

Example Request

cURL

curl "https://api.autoresourceco.com/api/v1/vin/decode-batch" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "vins": [
      "1N4AZ1BV5NC000001",
      "JTDKB20U48778057Z",
      "1HGCM82633A123456"
    ],
    "years": [2022, 2008, 2003]
  }'

Response Example

JSON

{
  "results": [
    {
      "VIN": "1n4az1bv5nc000001",
      "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": [
    {
      "vin": "JTDKB20U48778057Z",
      "error": "VIN check digit (position 9) is invalid"
    },
    {
      "vin": "1HGCM82633A123456",
      "error": "1 - Check Digit (9th position) does not calculate properly"
    }
  ],
  "summary": {
    "total": 3,
    "successful": 1,
    "failed": 2
  }
}

Response Fields

Field	Type	Description
results	object[]	Successful vehicle decodes, returned in the same public payload shape as single VIN decode.
errors	object[]	Per-VIN validation or upstream failures that did not prevent the overall batch response from completing.
summary.total	integer	Total number of VINs submitted in the request.
summary.successful / summary.failed	integer	Counts of successful and failed VINs after validation and upstream decode.

Related Docs

Authentication Errors and Limits