Drug Interaction Check | Medplum

Bot:

scriptsure-drug-interaction-bot

Checks one or more candidate drugs for drug-drug interactions (DDI) against a patient's current medication list in ScriptSure. Two modes are supported:

check (default) — lightweight DDI list
details — full FDB screening payload per candidate including allergy, age, and duplicate-therapy checks

If the prescriber has not completed ScriptSure EULA or identity proofing, returns { interactions: [], skipped: true, providerNotReady: true } rather than throwing.

const result = await medplum.executeBot(

{ system: 'https://www.medplum.com/bots', value: 'scriptsure-drug-interaction-bot' },

{
    patientId: 'patient-xyz',

candidateRoutedMedIds: [12345, 67890], // ScriptSure ROUTED_MED_ID integers

mode: 'check',       // 'check' (default) or 'details'

timeframeDays: 365,  // optional, defaults to 365

}
);

Input fields

Field	Type	Description
`patientId`	`string`	Medplum `Patient` resource ID
`candidateRoutedMedIds`	`number[]`	ScriptSure `ROUTED_MED_ID` integers for the drugs to check
`mode`	`'check'	'details'`
`timeframeDays`	`number`	Lookback window for current medications. Defaults to `365`

Response fields

All modes return the same top-level shape:

Field	Type	Description
`interactions`	`DrugInteraction[]`	DDI results. Empty array in `details` mode and when the provider is not ready.
`skipped`	`boolean`	`true` when the check was skipped because the provider has not completed EULA or identity proofing.
`providerNotReady`	`boolean`	`true` alongside `skipped` when the provider is not yet enrolled.
`details`	`Record<string, unknown>[]`	`details` mode only. One full FDB drugcheck response object per successfully resolved candidate. Shape varies by FDB version.
`detailsErrors`	`{ routedMedId: number; message: string }[]`	`details` mode only. Per-candidate resolution failures. Sibling candidates are still processed.

Each interactions item (check mode):

Field	Type	Description
`ROUTED_MED_ID`	`number`	The candidate drug that has an interaction
`DDI_DES`	`string`	Interaction description (e.g. `"LOOP DIURETICS/DESMOPRESSIN"`)
`DDI_SL`	`string`	Severity level code (FDB-defined; treat as opaque string)