{
  "title": "Vehicle recalls and complaints — settings",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "dataType": {
      "title": "Recalls, owner complaints or both",
      "type": "string",
      "description": "Recalls = official safety recalls. Complaints = owner-submitted complaints (ODI), including crash/fire/injury flags.",
      "editor": "select",
      "default": "recalls",
      "enum": [
        "recalls",
        "complaints",
        "both"
      ],
      "enumTitles": [
        "Recalls",
        "Owner complaints",
        "Both"
      ],
      "sectionCaption": "Vehicle or campaign"
    },
    "make": {
      "title": "Vehicle make",
      "type": "string",
      "description": "Vehicle make, e.g. 'Honda', 'Ford', 'Tesla'. Case-insensitive.",
      "editor": "textfield",
      "prefill": "Honda"
    },
    "model": {
      "title": "Exact model — optional",
      "type": "string",
      "description": "Exact NHTSA model name, e.g. 'Civic', 'F-150 SUPER CREW'. LEAVE EMPTY to automatically cover ALL models of the make for each year — the Actor discovers the exact model names for you.",
      "editor": "textfield",
      "example": "Civic"
    },
    "modelYears": {
      "title": "Model years to inspect",
      "type": "array",
      "description": "One or more 4-digit model years, e.g. 2022. Each year is fetched separately.",
      "editor": "stringList",
      "prefill": [
        "2022"
      ]
    },
    "campaignNumber": {
      "title": "Exact recall campaign — overrides filters",
      "type": "string",
      "description": "Look up one specific NHTSA recall campaign (e.g. '23V769000') across every vehicle it covers. When set, the other filters are ignored.",
      "editor": "textfield",
      "example": "23V769000"
    },
    "maxResults": {
      "title": "Maximum records to save",
      "type": "integer",
      "description": "Hard cap on the total number of records written to the dataset in one run, counting recalls and complaints together; the run stops as soon as it is reached. Raise it for whole-make sweeps - a single make/year can return thousands of complaints (Honda Civic 2022 alone has 881).",
      "editor": "number",
      "default": 1000,
      "minimum": 1
    },
    "maxRunSeconds": {
      "title": "Run time budget (seconds)",
      "type": "integer",
      "description": "Wall-clock budget for this run, in seconds. When it is reached the Actor stops cleanly and finishes successfully with the rows it already collected, instead of being killed mid-run. Whole-make mode (no \"model\") can mean dozens of models per year, each costing one or two requests. Raise it (and the run timeout in Run options) for a deliberately large job.",
      "editor": "number",
      "default": 240,
      "minimum": 30,
      "sectionCaption": "Run budget"
    }
  },
  "description": "For fleet researchers and automotive analysts, collect published NHTSA recalls and owner complaints with their distinct record types. Vehicle lines and campaigns recorded by NHTSA. Choose recalls, complaints or both; this is not a VIN-specific repair-status check."
}