{
  "format": "healthspanledger-research-codebook",
  "schemaVersion": 1,
  "dataset": {
    "id": "openfda-drug-shortages",
    "name": "FDA shortage status for GLP-1 drugs",
    "canonicalUrl": "https://healthspanledger.com/compounded/shortages",
    "edition": "2026.08",
    "version": "c8b4cf25d815"
  },
  "columns": [
    {
      "name": "drug",
      "type": "string",
      "nullable": false,
      "description": "Reader-facing drug substance searched in the shortage database."
    },
    {
      "name": "compound_slug",
      "type": "string",
      "nullable": false,
      "description": "Stable HealthspanLedger slug for the searched drug."
    },
    {
      "name": "in_shortage",
      "type": "boolean",
      "nullable": false,
      "description": "True only when at least one reconciled FDA row carries the status Current."
    },
    {
      "name": "status_summary",
      "type": "string",
      "nullable": false,
      "description": "Dated plain-language summary derived from the reconciled status counts."
    },
    {
      "name": "fda_records",
      "type": "number",
      "nullable": false,
      "description": "All reconciled FDA shortage-database rows returned for the drug.",
      "unit": "records"
    },
    {
      "name": "current_shortage_records",
      "type": "number",
      "nullable": false,
      "description": "Returned rows carrying FDA's Current shortage status.",
      "unit": "records"
    },
    {
      "name": "discontinuation_notice_records",
      "type": "number",
      "nullable": false,
      "description": "Returned rows that are discontinuation notices rather than current shortages.",
      "unit": "records"
    },
    {
      "name": "resolved_shortage_records",
      "type": "number",
      "nullable": false,
      "description": "Returned rows carrying a resolved or closed shortage status.",
      "unit": "records"
    },
    {
      "name": "matched_product_names",
      "type": "string",
      "nullable": false,
      "description": "Distinct product names in the reconciled FDA rows, separated by semicolons."
    },
    {
      "name": "last_record_update",
      "type": "string",
      "nullable": true,
      "description": "Most recent update date published among the returned FDA rows.",
      "missingMeaning": "No returned row publishes an update date."
    },
    {
      "name": "checked_on",
      "type": "string",
      "nullable": false,
      "description": "ISO date on which HealthspanLedger checked the shortage feed."
    },
    {
      "name": "search_expression",
      "type": "string",
      "nullable": false,
      "description": "Exact fielded openFDA expression used for this drug."
    }
  ]
}