{
  "title": "FDA adverse-event reports — settings",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "reportType": {
      "title": "Choose drug or device reports",
      "type": "string",
      "description": "Drug = FAERS adverse drug reaction reports (20M+). Device = MAUDE medical-device event reports (25M+).",
      "editor": "select",
      "default": "drug",
      "enum": [
        "drug",
        "device"
      ],
      "enumTitles": [
        "Drug adverse events (FAERS)",
        "Device adverse events (MAUDE)"
      ],
      "sectionCaption": "Product and report type"
    },
    "productName": {
      "title": "Product or generic name",
      "type": "string",
      "description": "Drug name (brand or generic, e.g. 'OZEMPIC', 'metformin') or device name (e.g. 'insulin pump', 'IMPELLA'). Matched against reported names and FDA-enriched brand/generic names. Leave empty for all products.",
      "editor": "textfield",
      "example": "OZEMPIC"
    },
    "reactionOrProblem": {
      "title": "Reaction or device problem",
      "type": "string",
      "description": "Drug mode: reaction term (MedDRA), e.g. 'Nausea', 'Pancreatitis'. Device mode: product problem, e.g. 'Material Rupture', 'Battery Problem'. Leave empty for all.",
      "editor": "textfield",
      "example": "Pancreatitis"
    },
    "seriousOnly": {
      "title": "Serious events only",
      "type": "boolean",
      "description": "Drug mode: only reports marked serious (death, hospitalization, life-threatening, disability). Device mode: only Death or Injury events (excludes malfunctions).",
      "editor": "checkbox",
      "default": false
    },
    "country": {
      "title": "Country (drug mode only)",
      "type": "string",
      "description": "Two-letter ISO country code for where the event occurred, e.g. US, CA, GB, JP. Drug mode only (ignored in device mode), and roughly 19% of FAERS reports leave this field blank, so filtering on it drops those reports.",
      "editor": "textfield",
      "example": "US"
    },
    "receivedSince": {
      "title": "FDA received date — from",
      "type": "string",
      "description": "Only reports the FDA received on or after this date (YYYY-MM-DD).",
      "editor": "textfield",
      "example": "2026-01-01"
    },
    "receivedUntil": {
      "title": "FDA received date — through",
      "type": "string",
      "description": "Only reports the FDA received on or before this date (YYYY-MM-DD).",
      "editor": "textfield",
      "example": "2026-06-30"
    },
    "maxResults": {
      "title": "Maximum reports to save",
      "type": "integer",
      "description": "Upper bound on reports returned per run. openFDA pages 999 records at a time and refuses a skip above 25,000, so one run tops out near 25,900 reports - split bigger pulls across runs with receivedSince / receivedUntil windows.",
      "editor": "number",
      "default": 500,
      "minimum": 1
    },
    "maxRunSeconds": {
      "title": "Run time budget (seconds)",
      "type": "integer",
      "description": "Wall-clock budget for this run, in seconds. When it is reached the Actor stops cleanly and finishes successfully with the rows it already collected, instead of being killed mid-run. Pages hold 999 reports, so only a very large \"maxResults\" gets near it. Raise it (and the run timeout in Run options) for a deliberately large job.",
      "editor": "number",
      "default": 240,
      "minimum": 30,
      "sectionCaption": "Run budget"
    }
  },
  "description": "For safety researchers and product teams, bring FDA drug or device reports into a table you can filter and review. Choose FAERS drug reports or MAUDE device reports per run. Country filtering applies only to drug mode."
}