{
  "format": "healthspanledger-research-codebook",
  "schemaVersion": 1,
  "dataset": {
    "id": "faers-dosing-errors",
    "name": "Dose-handling reports by product form, from FDA FAERS",
    "canonicalUrl": "https://healthspanledger.com/dosing-errors",
    "edition": "2026.08",
    "version": "4ccde919bfa3"
  },
  "columns": [
    {
      "name": "drug",
      "type": "string",
      "nullable": false,
      "description": "Brand or product name used to identify this report cohort."
    },
    {
      "name": "molecule",
      "type": "string",
      "nullable": false,
      "description": "Active drug substance associated with the named product."
    },
    {
      "name": "application_holder",
      "type": "string",
      "nullable": false,
      "description": "Company holding the FDA application for the named product."
    },
    {
      "name": "device_class",
      "type": "string",
      "nullable": false,
      "description": "Reader-facing grouping based on how a dose is obtained from the presentation."
    },
    {
      "name": "presentation",
      "type": "string",
      "nullable": false,
      "description": "FDA-labeled product presentations included under the brand-level query."
    },
    {
      "name": "total_reports",
      "type": "number",
      "nullable": false,
      "description": "All FAERS reports returned by the product-specific denominator query.",
      "unit": "reports"
    },
    {
      "name": "incorrect_dose_reports",
      "type": "number",
      "nullable": true,
      "description": "Reports naming the MedDRA term INCORRECT DOSE ADMINISTERED when it appears in the stored top 25.",
      "unit": "reports",
      "missingMeaning": "The term fell outside the stored top 25; absence is not a measured zero."
    },
    {
      "name": "incorrect_dose_share_of_drug_reports",
      "type": "number",
      "nullable": false,
      "description": "Incorrect-dose count divided by that product's total report count, or its conservative upper bound.",
      "unit": "fraction from 0 to 1"
    },
    {
      "name": "incorrect_dose_share_is_upper_bound",
      "type": "boolean",
      "nullable": false,
      "description": "True when the published incorrect-dose share is a ceiling rather than a measured value."
    },
    {
      "name": "incorrect_dose_rank_among_stored_terms",
      "type": "number",
      "nullable": true,
      "description": "Rank of INCORRECT DOSE ADMINISTERED among the product's stored terms.",
      "missingMeaning": "The term did not appear among the stored top 25 terms."
    },
    {
      "name": "nausea_reports",
      "type": "number",
      "nullable": true,
      "description": "Reports naming the MedDRA term NAUSEA when it appears in the stored top 25.",
      "unit": "reports",
      "missingMeaning": "The term fell outside the stored top 25; absence is not a measured zero."
    },
    {
      "name": "nausea_share_of_drug_reports",
      "type": "number",
      "nullable": false,
      "description": "Nausea count divided by that product's total report count, or its conservative upper bound.",
      "unit": "fraction from 0 to 1"
    },
    {
      "name": "nausea_share_is_upper_bound",
      "type": "boolean",
      "nullable": false,
      "description": "True when the published nausea share is a ceiling rather than a measured value."
    },
    {
      "name": "dose_term_family_share_floor",
      "type": "number",
      "nullable": false,
      "description": "Lowest supported share after combining the four dose-handling terms without inventing missing counts.",
      "unit": "fraction from 0 to 1"
    },
    {
      "name": "dose_term_family_share_ceiling",
      "type": "number",
      "nullable": false,
      "description": "Highest supported share after bounding dose-handling terms outside the stored top 25.",
      "unit": "fraction from 0 to 1"
    },
    {
      "name": "dose_term_family_terms_outside_stored",
      "type": "number",
      "nullable": false,
      "description": "Number of the four dose-handling terms missing from the stored top 25.",
      "unit": "terms"
    },
    {
      "name": "serious_share_of_drug_reports",
      "type": "number",
      "nullable": false,
      "description": "Share of the product's report cohort that FDA classified as serious.",
      "unit": "fraction from 0 to 1"
    },
    {
      "name": "twenty_fifth_stored_term_reports",
      "type": "number",
      "nullable": false,
      "description": "Report count of the product's 25th-ranked stored term, used to set upper bounds.",
      "unit": "reports"
    },
    {
      "name": "search_expression",
      "type": "string",
      "nullable": false,
      "description": "Exact openFDA search expression used to build the product-specific report denominator."
    }
  ]
}