Product & Vehicle Recall Search (FDA / NHTSA / CPSC)

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "search text. For agency=nhtsa pass '<make> <model> <year>'"
    },
    "limit": {
      "type": "string",
      "default": "25"
    },
    "agency": {
      "enum": [
        "fda",
        "cpsc",
        "nhtsa",
        "all"
      ],
      "type": "string",
      "default": "all",
      "description": "usda/FSIS is unavailable (agency blocks bots)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of recall entries in `items`."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "null",
            "description": "A link to the recall's own detail page. Observed `null` on every entry in both fixtures captured, regardless of agency -- whether the vendor ever populates this is unconfirmed."
          },
          "date": {
            "type": "string",
            "description": "The recall's report/issue date, 'YYYY-MM-DD'."
          },
          "type": {
            "type": "string",
            "description": "Observed as the literal string 'recall' on every entry."
          },
          "state": {
            "type": "string",
            "description": "FDA-specific: a two-letter US state code. Present on every entry in the FDA fixture captured; absent entirely on every entry in the NHTSA fixture -- presence for CPSC is unconfirmed."
          },
          "agency": {
            "type": "string",
            "description": "The recall's issuing authority, e.g. 'NHTSA' or 'FDA'."
          },
          "reason": {
            "type": "string",
            "description": "Free-text explanation of why the product was recalled."
          },
          "remedy": {
            "type": "string",
            "description": "NHTSA-specific: free-text repair/remedy instructions, which can include the recalling manufacturer's own published customer-service phone number (e.g. '1-800-331-4331') -- a public corporate contact line, not a private individual's. Present on every entry in the NHTSA fixture captured; absent entirely on every entry in the FDA fixture -- presence for CPSC is unconfirmed."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "e.g. 'Terminated'. Populated on every entry in the FDA fixture captured; observed `null` on every entry in the NHTSA fixture captured -- unconfirmed for CPSC."
          },
          "company": {
            "type": "string",
            "description": "The recalling manufacturer's or company's own public business name, e.g. 'Toyota Motor Engineering & Manufacturing'."
          },
          "product": {
            "type": "string",
            "description": "Free-text description of the affected product, ranging from a short phrase ('2020 TOYOTA CAMRY') to a long label/packaging description (FDA entries). Not a phone number in any entry checked in both captured fixtures."
          },
          "severity": {
            "type": [
              "string",
              "null"
            ],
            "description": "e.g. 'high'/'medium'/'low'. Populated on every entry in the FDA fixture captured; observed `null` on every entry in the NHTSA fixture captured -- unconfirmed for CPSC."
          },
          "component": {
            "type": "string",
            "description": "NHTSA-specific: the vehicle system/part implicated, e.g. 'AIR BAGS:SENSOR:OCCUPANT CLASSIFICATION'. Present on every entry in the NHTSA fixture captured; absent entirely (not merely null) on every entry in the FDA fixture -- presence for CPSC is unconfirmed."
          },
          "consequence": {
            "type": "string",
            "description": "NHTSA-specific: free-text description of the risk if unaddressed. Present on every entry in the NHTSA fixture captured; absent entirely on every entry in the FDA fixture -- presence for CPSC is unconfirmed."
          },
          "distribution": {
            "type": "string",
            "description": "FDA-specific: free-text description of where the recalled product was shipped/sold. Present on every entry in the FDA fixture captured; absent entirely on every entry in the NHTSA fixture -- presence for CPSC is unconfirmed."
          },
          "recallNumber": {
            "type": "string",
            "description": "The issuing agency's own recall identifier, e.g. '23V865000' (NHTSA) or 'F-0718-2019' (FDA). An alphanumeric identifier, not a phone number, in every entry checked in both captured fixtures."
          },
          "classification": {
            "type": [
              "string",
              "null"
            ],
            "description": "FDA-style severity classification, e.g. 'Class I'/'Class II'/'Class III'. Populated on every entry in the FDA fixture captured; observed `null` on every entry in the NHTSA fixture captured -- unconfirmed for CPSC."
          }
        },
        "additionalProperties": true
      },
      "description": "One entry per matching recall record."
    }
  },
  "description": "The search result, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}