Previous value: -"NHTSA campaign number (e.g., \"20V682000\"). When provided, returns the campaign detail plus every vehicle it covers. Mutually exclusive with make/model/modelYear."New value: +"NHTSA campaign number (e.g., \"20V682000\"). When provided, returns the campaign detail plus every vehicle it covers. A 6-character number (e.g., \"00V419\") returns every campaign it covers, each with its own detail and vehicles. Mutually exclusive with make/model/modelYear."

Previous value: -"Inclusive received-date bounds in YYYY-MM-DD, in either lookup mode. Blank bounds are unset; records without a usable date are excluded only with active bounds."New value: +"Inclusive received-date bounds in YYYY-MM-DD, in every mode; a bound alone is a broad search. Blank bounds are unset; records without a usable date are excluded only with active bounds."

Added value: +{
+  "description": "Campaigns per page of a broad search. Defaults to 20; at most 50 per page. Not accepted with campaignNumber or a full make + model + modelYear lookup, which return every match.",
+  "minimum": 1,
+  "multipleOf": 1,
+  "type": "number"
+}

Previous value: -"Vehicle manufacturer. Required with model and modelYear when not using campaignNumber."New value: +"Vehicle make (e.g., \"Toyota\"). With model and modelYear, looks up that vehicle's recalls; otherwise a broad-search filter matching the whole make name, ignoring case."

Previous value: -"Vehicle model. Required with make and modelYear."New value: +"Vehicle model. With make and modelYear, looks up that vehicle's recalls; otherwise a broad-search filter matching the whole model name, ignoring case."

Previous value: -"Model year, a whole number. Required with make and model."New value: +"Model year, a whole number. With make and model, looks up that vehicle's recalls; otherwise a broad-search filter."

Added value: +{
+  "description": "Pagination offset into the newest-first results of a broad search. Defaults to 0. Not accepted with campaignNumber or a full make + model + modelYear lookup.",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

Previous value: -"The search key used: campaign number, or \"make model modelYear\" for vehicle queries."New value: +"The search key used: campaign number, \"make model modelYear\" for a vehicle lookup, or the broad-search filters as key=value pairs with make and model uppercased as matched, plus any active date bounds."

Previous value: -"Machine-readable failure mode. Declared by this tool: `mode_conflict`: Both campaignNumber and vehicle params were provided. `missing_required_combo`: Neither campaignNumber nor a complete vehicle triple was supplied. `campaign_not_found`: The campaignNumber did not match any NHTSA recall. `invalid_date`: A dateRange bound is not a calendar-valid YYYY-MM-DD date. `inverted_date_range`: dateRange.after is later than dateRange.before. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `mode_conflict`: campaignNumber was combined with make, model, or modelYear; or limit or offset was sent with campaignNumber or a full make + model + modelYear lookup. `missing_required_combo`: No campaignNumber, make, model, modelYear, or active dateRange bound was supplied. `limit_too_large`: limit exceeds the 50-row page maximum on a server set to reject an over-maximum limit rather than lower it. `campaign_not_found`: The campaignNumber did not match any NHTSA recall. `invalid_date`: A dateRange bound is not a calendar-valid YYYY-MM-DD date. `inverted_date_range`: dateRange.after is later than dateRange.before. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "mode_conflict",
-  "missing_required_combo",
-  "campaign_not_found",
-  "invalid_date",
-  "inverted_date_range"
-]New value: +[
+  "mode_conflict",
+  "missing_required_combo",
+  "limit_too_large",
+  "campaign_not_found",
+  "invalid_date",
+  "inverted_date_range"
+]

Added value: +{
+  "description": "Broad search only: pagination limit used for this page",
+  "type": "number"
+}

Previous value: -"Guidance when no recalls are found — e.g. how to verify make/model/year spelling."New value: +"Guidance when no recalls match: for a vehicle lookup, how to list the other model names NHTSA may file its recalls under with nhtsa_lookup_vehicles operation=\"dataset_models\"; for a broad search, which filters to relax. Also explains a date range that excluded every recall, a broad-search page past the last match, and a limit lowered to the page maximum."

Added value: +{
+  "description": "Broad search only: pagination offset used for this page",
+  "type": "number"
+}

Previous value: -"Matching recall campaigns"New value: +"Matching recall campaigns; in a broad search, one page of them"

Previous value: -"Affected component (vehicle-scoped queries)"New value: +"Affected component. A broad search joins all of the campaign's components with \" | \"."

Previous value: -"Safety consequence"New value: +"Safety consequence. Omitted for older campaigns whose record leaves it blank."

Previous value: -"OTA update availability when provided by NHTSA"New value: +"OTA update availability when provided by NHTSA. Never set by a broad search: NHTSA's recall files carry no such flag."

Previous value: -"Units affected (campaign queries)"New value: +"Units affected (campaign queries and broad searches)"

Previous value: -"Corrective action"New value: +"Corrective action. Omitted for older campaigns whose record leaves it blank."

Previous value: -"Recall summary"New value: +"Recall summary. Omitted for older campaigns whose record leaves it blank."

Previous value: -[
-  "campaignNumber",
-  "manufacturer",
-  "summary",
-  "consequence",
-  "remedy",
-  "reportReceivedDate"
-]New value: +[
+  "campaignNumber",
+  "manufacturer",
+  "reportReceivedDate"
+]

Added value: +{
+  "description": "Broad search only: campaigns in this page",
+  "type": "number"
+}

Previous value: -"Total recalls matching criteria"New value: +"Total recalls matching criteria; in a broad search, across every page"

Previous value: -"Filter recalls by received date. Applied locally since the API lacks native date filtering."New value: +"Inclusive received-date bounds in YYYY-MM-DD, in either lookup mode. Blank bounds are unset; records without a usable date are excluded only with active bounds."

Previous value: -"Only recalls received after this date (ISO 8601, e.g., \"2025-01-01\")."New value: +"Inclusive lower bound, a calendar date in YYYY-MM-DD. Blank means unset."

Previous value: -"Only recalls received before this date (ISO 8601, e.g., \"2026-01-01\")."New value: +"Inclusive upper bound, a calendar date in YYYY-MM-DD. Blank means unset."

Previous value: -"Machine-readable failure mode. Declared by this tool: `mode_conflict`: Both campaignNumber and vehicle params were provided. `missing_required_combo`: Neither campaignNumber nor a complete vehicle triple was supplied. `campaign_not_found`: The campaignNumber did not match any NHTSA recall. `invalid_date`: A dateRange bound could not be parsed as a date. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `mode_conflict`: Both campaignNumber and vehicle params were provided. `missing_required_combo`: Neither campaignNumber nor a complete vehicle triple was supplied. `campaign_not_found`: The campaignNumber did not match any NHTSA recall. `invalid_date`: A dateRange bound is not a calendar-valid YYYY-MM-DD date. `inverted_date_range`: dateRange.after is later than dateRange.before. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "mode_conflict",
-  "missing_required_combo",
-  "campaign_not_found",
-  "invalid_date"
-]New value: +[
+  "mode_conflict",
+  "missing_required_combo",
+  "campaign_not_found",
+  "invalid_date",
+  "inverted_date_range"
+]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "recalls",
+      "totalCount",
+      "effectiveQuery"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `mode_conflict`: Both campaignNumber and vehicle params were provided. `missing_required_combo`: Neither campaignNumber nor a complete vehicle triple was supplied. `campaign_not_found`: The campaignNumber did not match any NHTSA recall. `invalid_date`: A dateRange bound could not be parsed as a date. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "mode_conflict",
+            "missing_required_combo",
+            "campaign_not_found",
+            "invalid_date"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "recalls",
-  "totalCount",
-  "effectiveQuery"
-]

Previous value: -"NHTSA campaign number (e.g., \"20V682000\"). When provided, returns campaign details. Other params ignored."New value: +"NHTSA campaign number (e.g., \"20V682000\"). When provided, returns the campaign detail plus every vehicle it covers. Mutually exclusive with make/model/modelYear."

Previous value: -"Model year. Required with make and model."New value: +"Model year, a whole number. Required with make and model."

Added value: +9007199254740991

Added value: +-9007199254740991

Previous value: -"number"New value: +"integer"

Added value: +{
+  "description": "Every distinct make/model the campaign covers (campaign queries). Equipment and tire campaigns name the part here — make is the brand, model is the part — and carry no model year.",
+  "items": {
+    "additionalProperties": false,
+    "description": "One vehicle covered by the campaign",
+    "properties": {
+      "make": {
+        "description": "Vehicle make",
+        "type": "string"
+      },
+      "model": {
+        "description": "Vehicle model",
+        "type": "string"
+      },
+      "modelYear": {
+        "description": "Model year",
+        "type": "number"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "ODI investigation that preceded this campaign, when NHTSA links one (campaign queries) — pass it as nhtsaId to nhtsa_search_investigations for the full record.",
+  "type": "string"
+}

Previous value: -"Date received by NHTSA"New value: +"Date received by NHTSA (ISO YYYY-MM-DD)"

Removed value: -{
-  "description": "Recall subject (campaign queries)",
-  "type": "string"
-}

Added value: +{
+  "description": "The search key used: campaign number, or \"make model modelYear\" for vehicle queries.",
+  "type": "string"
+}

Added value: +{
+  "description": "Guidance when no recalls are found — e.g. how to verify make/model/year spelling.",
+  "type": "string"
+}

Previous value: -[
-  "recalls",
-  "totalCount"
-]New value: +[
+  "recalls",
+  "totalCount",
+  "effectiveQuery"
+]

Added value: +"A single recall campaign"