Retrieve a patient's medication list

Last updated: Nov 6, 2024

HEALTH TECH VENDOR

IMPLEMENTATION

PRODUCT OWNER

You can use this API action to access a list of a patient’s prescribed medications, as documented by a specific organization.

With this API action, you can retrieve information like medication type, dose, status, timing, frequency, quantity, and more.

Patient identifier required

To use this API action, you must know the patient identifier. If you don’t, you must locate the appropriate identifier first. Learn how to search for a patient with demographics.

Use cases

This API action may be a good fit for your organization if you perform any of these use cases:

Track a patient’s current medications.
Remind patients to take current medications at the appropriate time.

Supported systems

You can use this API action with the Redox FHIR® API.

Your connection's system can return results with their own FHIR® or query-based API.

Things you need to know

Organization-specific

Which medication FHIR resource to use

Data variation and availability

Medication codes

Provider comments

What's next?

Does this API action seem like a good fit for your unique workflow? If so, let your Redox technical account manager know! You can start development by downloading the relevant resource schema (noted in the related action step below) and deciding which data elements you need. Then, use the Quickstart for Redox guide to dive right in.

If you're not engaged with our sales team yet, talk to a Redoxer to get started.

Action steps

Prerequisites

The following actions must be completed before attempting the steps below.

1
Search for a patient with demographics

Steps

1
Retrieve a patient's prescribed medications
optional
2
Retrieve a patient's administered medications during an inpatient visit
optional

Retrieve a patient's prescribed medications

This table has notes about how to use parameters for this action step specifically, but it's not exhaustive. Refer to the MedicationRequest schema for more details.

Parameter	Required	Notes
patient.identifier	Y	You must include at least one identifier for the patient that the EHR system uses. If you don't have a patient identifier, search for a patient with demographics to find one.
intent	N	When using MedicationRequest, you can use both patient identifier and intent to refine your search. If using intent, you can search with any of these values: proposal, plan, order, original-order, reflex-order, filler-order, instance-order, option.

The response contains one or more medications for an individual patient. In FHIR® responses, you can find the total number of included medications in the total array.

MedicationRequest/_search

Select sandbox

Select format

Query

bash

1
curl 'https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/MedicationRequest/_search' \
2
--request POST \
3
--header 'Authorization: Bearer ${API_TOKEN}' \
4
--header 'Content-Type: application/x-www-form-urlencoded' \
5
--data-urlencode 'patient=Patient/81c2f5eb-f99f-40c4-b504-59483e6148d7' \
6
--data-urlencode 'intent=order'

Response

json

1
{
2
  "id": "e23a63fb-f611-4492-88c5-8b293b2fa1b5",
3
  "type": "searchset",
4
  "entry": [
5
    {
6
      "search": {
7
        "mode": "match",
8
        "score": 1
9
      },
10
      "resource": {
11
        "id": "9d1810d9-64c8-45ea-8443-e73a3681eb32",
12
        "meta": {
13
          "lastUpdated": "2022-10-06T18:58:36.668Z"
14
        },
15
        "intent": "order",
16
        "status": "active",
17
        "subject": {
18
          "reference": "Patient/81c2f5eb-f99f-40c4-b504-59483e6148d7"
19
        },
20
        "recorder": {
21
          "reference": "Practitioner/dbed0f85-e3cd-47ac-9305-3f629e138832"
22
        },
23
        "contained": [
24
          {
25
            "id": "364afc13-9969-491d-8d42-6bfebbb35429",
26
            "name": "Fake Pharmacy",
27
            "type": [
28
              {
29
                "text": "Pharmacy",
30
                "coding": [
31
                  {
32
                    "code": "PHARM",
33
                    "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
34
                    "display": "Pharmacy"
35
                  }
36
                ]
37
              }
38
            ],
39
            "active": true,
40
            "address": [
41
              {
42
                "city": "Madison",
43
                "line": [
44
                  "123 Fake Street"
45
                ],
46
                "state": "WI",
47
                "postalCode": 53703
48
              }
49
            ],
50
            "identifier": [
51
              {
52
                "value": "1234567",
53
                "system": "urn:redox:redox-fhir-sandbox:NCPDP"
54
              }
55
            ],
56
            "resourceType": "Organization"
57
          }
58
        ],
59
        "encounter": {
60
          "reference": "Encounter/f221f862-7a5a-499c-bc1c-d3028b9acb5a"
61
        },
62
        "requester": {
63
          "reference": "Practitioner/dbed0f85-e3cd-47ac-9305-3f629e138832"
64
        },
65
        "identifier": [
66
          {
67
            "value": "30c6f13a-01f0-4012-b913-2572ccfc02e4",
68
            "system": "urn:redox:redox-fhir-sandbox:MedOrderID",
69
            "extension": [
70
              {
71
                "url": "https://fhir.redoxengine.com/StructureDefinition/identifier-origin",
72
                "valueString": "RedoxAPI"
73
              }
74
            ]
75
          }
76
        ],
77
        "resourceType": "MedicationRequest",
78
        "dispenseRequest": {
79
          "performer": {
80
            "reference": "#364afc13-9969-491d-8d42-6bfebbb35429"
81
          }
82
        },
83
        "dosageInstruction": [
84
          {
85
            "route": {
86
              "text": "Oral",
87
              "coding": [
88
                {
89
                  "code": "C38288",
90
                  "system": "urn:oid:2.16.840.1.113883.3.26.1.1"
91
                }
92
              ]
93
            },
94
            "timing": {
95
              "repeat": {
96
                "period": 8,
97
                "frequency": 1,
98
                "periodUnit": "h",
99
                "boundsPeriod": {
100
                  "start": "2022-09-12T16:10:35.874Z"
101
                }
102
              }
103
            },
104
            "doseAndRate": [
105
              {
106
                "doseQuantity": {
107
                  "unit": "mg",
108
                  "value": 4
109
                }
110
              }
111
            ]
112
          }
113
        ],
114
        "medicationCodeableConcept": {
115
          "text": "Ondansetron 4 Mg Po Tbdp",
116
          "coding": [
117
            {
118
              "code": "104894",
119
              "system": "http://www.nlm.nih.gov/research/umls/rxnorm"
120
            }
121
          ]
122
        }
123
      }
124
    }
125
  ],
126
  "total": 1,
127
  "resourceType": "Bundle"
128
}

Retrieve a patient's administered medications during an inpatient visit

This table has notes about how to use parameters for this action step specifically, but it's not exhaustive. Refer to the MedicationAdministration schema for more details.

Parameter	Required	Notes
patient.identifier	Y	You must include at least one identifier for the patient that the EHR system uses. If you don't have a patient identifier, search for a patient with demographics to find one.