openrecalls

GET /openrecalls/{vin}

Changed on

Request

  • Base URL
    https://api.auto.dev
  • Auth
    none declared

Path parameters

vinstring required

Vehicle Identification Number

Example:1HGCM82633A123456

Query parameters

makestring

Override make from VIN decode

modelstring

Override model from VIN decode

recalls'true' | 'false'

When set to true, the response includes an additional recalls array carrying the full make/model/year recall catalog (the same payload /recalls/{vin} returns in its data field) alongside the open-only data array. Useful when callers want both open campaigns for the VIN and the vehicle's full historical recall record in a single round trip.

yearstring

Override year from VIN decode

Response

Success

examplesobject

Navigation links to related resources.

openRecallsnumber required

Number of open recalls — equals data.length.

retrievedAtunknown required
statusstring required

Human-readable summary, e.g. "1 Open Recall" or "No Open Recalls".

totalRecallsnumber required

Total campaigns issued for this year/make/model, including ones already remedied for this VIN, so it can exceed openRecalls.

Changes

    • warning

      added the new Enterprise enum value to the / response property for the response status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status