vin
recalls

Recalls listed for a VIN's model year

get/v2/vin/{vin}/recalls

Request

  • Base URL: https://api.cardog.app
  • URL: https://api.cardog.app/v2/vin/{vin}/recalls
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

vinstring required

17-character VIN

Response

Campaigns listed for the model year (possible recalls; the manufacturer confirms by VIN)

vinstring required
modelYearRefstring nullable required

Entity ref ({domain}:{key}) in the "model-year" domain. Example: "model-year:toyota/rav4/2021"

resolvedboolean required

False when the VIN is neither in the vehicle graph nor decodable to a model year. recalls is then empty because nothing could be checked, not because the vehicle is clear.

source'observed' | 'decoded'

How the VIN was matched to a model year: 'observed' (the exact VIN is in the vehicle graph) or 'decoded' (the VIN decoder derived it). Campaigns match at the model-year level, not by serial number; absent when resolved is false.

totalinteger required
asOfstring

When the recall data was last updated (ISO 8601)

linksobject

Related resources, keyed by relation name, each a server-relative path. Example: {"recalls": "/v2/recalls/entity/model-year:toyota/rav4/2021"}

Changes

No recorded changes to this operation across all 1 revision of this API.