{
  "format": "healthspanledger-research-codebook",
  "schemaVersion": 1,
  "dataset": {
    "id": "openfda-drug-recalls",
    "name": "FDA drug recall records for GLP-1 and peptide products",
    "canonicalUrl": "https://healthspanledger.com/compounded/supply-chain",
    "edition": "2026.08",
    "version": "33d460f14b0e"
  },
  "columns": [
    {
      "name": "matched_search_terms",
      "type": "string",
      "nullable": false,
      "description": "Every tracked compound or class term whose search returned this FDA recall event, separated by semicolons."
    },
    {
      "name": "matched_compound_slugs",
      "type": "string",
      "nullable": true,
      "description": "Stable HealthspanLedger slugs for tracked compounds associated with the recall event, separated by semicolons.",
      "missingMeaning": "The event was returned only by the broader class-comparator search and is not associated with a tracked compound."
    },
    {
      "name": "includes_class_comparator",
      "type": "boolean",
      "nullable": false,
      "description": "Whether the broader compounding-class comparison also returned this recall event."
    },
    {
      "name": "search_match_count",
      "type": "number",
      "nullable": false,
      "description": "Number of distinct tracked searches that returned the same FDA recall number.",
      "unit": "search matches"
    },
    {
      "name": "recall_number",
      "type": "string",
      "nullable": false,
      "description": "Stable FDA recall number identifying the enforcement record."
    },
    {
      "name": "classification_fda",
      "type": "string",
      "nullable": false,
      "description": "Hazard classification exactly as FDA publishes it."
    },
    {
      "name": "classification",
      "type": "string",
      "nullable": false,
      "description": "Normalized hazard classification used by HealthspanLedger."
    },
    {
      "name": "status_fda",
      "type": "string",
      "nullable": false,
      "description": "Recall process status exactly as FDA publishes it."
    },
    {
      "name": "status",
      "type": "string",
      "nullable": false,
      "description": "Normalized recall process status used by HealthspanLedger."
    },
    {
      "name": "recalling_firm",
      "type": "string",
      "nullable": false,
      "description": "Firm named by FDA as conducting the recall."
    },
    {
      "name": "state",
      "type": "string",
      "nullable": false,
      "description": "State abbreviation published for the recalling firm."
    },
    {
      "name": "product_description",
      "type": "string",
      "nullable": false,
      "description": "Affected product description published by FDA."
    },
    {
      "name": "reason_for_recall",
      "type": "string",
      "nullable": false,
      "description": "Reason for the recall published by FDA."
    },
    {
      "name": "code_info",
      "type": "string",
      "nullable": false,
      "description": "Lot numbers, expiration dates and other affected-batch identifiers published by FDA.",
      "missingMeaning": "FDA publishes no batch code information for this recall event."
    },
    {
      "name": "product_quantity",
      "type": "string",
      "nullable": true,
      "description": "Affected quantity text published by FDA.",
      "missingMeaning": "FDA publishes no product quantity for this record."
    },
    {
      "name": "distribution_pattern",
      "type": "string",
      "nullable": false,
      "description": "Geographic distribution wording published by FDA."
    },
    {
      "name": "voluntary_or_mandated",
      "type": "string",
      "nullable": false,
      "description": "FDA wording describing whether and how the recall was initiated."
    },
    {
      "name": "recall_initiation_date",
      "type": "string",
      "nullable": false,
      "description": "ISO date the recalling firm initiated the recall."
    },
    {
      "name": "center_classification_date",
      "type": "string",
      "nullable": false,
      "description": "ISO date on which FDA assigned the event's hazard classification.",
      "missingMeaning": "FDA publishes no center-classification date for this recall event."
    },
    {
      "name": "report_date",
      "type": "string",
      "nullable": false,
      "description": "ISO date attached to the published enforcement report."
    },
    {
      "name": "fda_matched_an_approved_listing",
      "type": "boolean",
      "nullable": false,
      "description": "Whether FDA's record links the recalled product to an approved-drug listing."
    }
  ]
}