Medications

The Medications feature allows the user to view  the list of  the  pre- admission  and post discharge medication details for the stay. It all allows the user to view all the medications provided during the patient stay in the hospital.

Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit

Get list of all medication details for a hospital stay

GET
/v1/{practiceid}/stays/{stayid}/medications
BETA: Retrieves all administered, pre-admission and post-discharge medication details for a stay. Note: This API returns inpatient medication types depending on input filtering options, does NOT filter on dates.
Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
stayid integer stayid
showpreadmissionlist boolean If set to true, pre-admission medications will be returned. By default false.
showpostdischargelist boolean If set to true, post-discharge medications will be returned. By default false.
showadministeredlist boolean If set to true, administered medications will be returned. By default true.
limit integer Number of entries to return (default 1500, max 5000)
offset integer Starting point of entries; 0-indexed
THIRDPARTYUSERNAME string User name of the patient in the third party application.
PATIENTFACINGCALL boolean When 'true' is passed we will collect relevant data and store in our database.

Output Parameters

Expand all
administeredname string Name of the care team member who administered the medication when available.
administerstartdate string The date the medication was administered to the patient. Returned in mm/dd/yyyy hh24:mi:ss format.
administerstopdate string The date the medication stopped being administered. Returned in mm/dd/yyyy hh24:mi:ss format.
code string The code in the external vocabulary.
codeset string Determines how to interpret the code in the external vocabulary. Currently uses RxNorm identifiers for medications. For branded medications, prefers a branded RxNorm and if not available then generic. Generic medications use generic RxNorms if available.
departmentid integer The ID of the department where the patient was in when they were administered the medication.
dosageadditionalinstructions string Additional instructions for how/when the medication is taken. Example: in the evening.
dosagedurationunit string The unit of the duration.
dosagedurationvalue string How many duration time units this medication should be taken for.
dosagefrequencydescription string A standardized patient-friendly frequency. Example: every day.
dosagefrequencyunit string The unit of the frequency. Example: days.
dosagefrequencyvalue string How many times (in the given time unit) this should be taken.
dosagequantityunit string The unit of the quantity. Example: tablets, sprays, etc.
dosagequantityvalue integer How many of this medication was taken.
dosageroute string How this medication is taken. Example: PO, Irrigation, etc.
enddatetime string The date the medication was ended. Returned in iso8601 format.
genericrxnorm string The name of the generic RxNorm.
genericrxnormid string The generic RxNorm id.
isprn string Whether or not the order was ordered as "pro re nata", or "as needed".
medicationid string Athena Medication Id for context.
medicationlisttype string One of the three medication list type namely Pre-Admission/Administered/Post-Discharge.
medicationname string The name of the medication.
ndc string The NDC number that corresponds to the medication when available.
ordereddate string The date that the provider ordered the medication when available. Returned in mm/dd/yyyy hh24:mi:ss format.
orderid integer The unique athena ID of this instance of the order.
patientid integer The ID of the patient's data that is being returned.
prnnote string If the order was ordered as PRN, the note will describe what symptoms the medication should be given for. Example: as needed for pain.
providerid integer The ID of the provider who ordered the medication.
signingproviderid integer The ID of the provider who signed the medication.
startdatetime string The date the medication was started. Returned in iso8601 format.
status string The date the medication was administered to the patient. Returned in mm/dd/yyyy hh24:mi:ss format.
stayid integer The stay ID.
Example Code

Get list of pre-admission and post-discharge medication details for a stay

GET
/v1/{practiceid}/stays/{stayid}/dischargemedications
BETA: Retrieves pre-admission and post-discharge (as what has changed) medication details for a stay. Note: This API retrieves home medications and changes to home medications as relates to an inpatient stay. They are divided into the groups PREADMISSION, STOP, START, and CONTINUE.
Was this information helpful? Yes | No Thank you for your feedback! What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Submit
Try in Postman

Input Parameters

Expand all

required

practiceid integer practiceid
stayid integer stayid
THIRDPARTYUSERNAME string User name of the patient in the third party application.
PATIENTFACINGCALL boolean When 'true' is passed we will collect relevant data and store in our database.

Output Parameters

Expand all
continue array The list of medications to continue upon discharge
outstandingreconciliation string True if there are medications that still need reconciliation.
preadmission array The list of medications present before admission
start array The list of medications to start upon discharge
stop array The list of medications to stop upon discharge
Example Code