Retrieve a patient's medication list

Last updated: Apr 30, 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.

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

Action steps

Prerequisites

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

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: proposalplanorderoriginal-orderreflex-orderfiller-orderinstance-orderoption.

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
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.

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.

MedicationAdministration/_search
Query
bash
1
curl 'https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/MedicationAdministration/_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'
Response
json
1
{
2
"id": "7dd5520f-a778-4aea-aafb-91b0f4eab868",
3
"resourceType": "Bundle",
4
"type": "searchset",
5
"entry": [
6
{
7
"resource": {
8
"resourceType": "MedicationAdministration",
9
"id": "4eccd037-4f1e-408d-a29b-e722f31608de",
10
"subject": {
11
"reference": "Patient/81c2f5eb-f99f-40c4-b504-59483e6148d7"
12
},
13
"identifier": [
14
{
15
"value": "83927393",
16
"system": "urn:oid:1.2.840.114350.1.13.12345.1.7.2.798268",
17
"extension": [
18
{
19
"url": "https://fhir.redoxengine.com/StructureDefinition/identifier-origin",
20
"valueString": "RedoxAPI"
21
}
22
]
23
}
24
],
25
"status": "completed",
26
"medicationCodeableConcept": {
27
"coding": [
28
{
29
"code": "573621",
30
"system": "http://www.nlm.nih.gov/research/umls/rxnorm",
31
"display": "Albuterol 0.09 MG/ACTUAT inhalant solution"
32
}
33
]
34
},
35
"context": {
36
"reference": "Encounter/e222f44d-428f-446f-8481-e8aeae326ab7"
37
},
38
"effectiveDateTime": "2022-08-10T04:00:00.000Z",
39
"dosage": {
40
"dose": {
41
"unit": "mg/actuat",
42
"value": 0.09
43
},
44
"route": {
45
"text": "RESPIRATORY (INHALATION)",
46
"coding": [
47
{
48
"code": "C38216",
49
"system": "urn:oid:2.16.840.1.113883.3.26.1.1"
50
}
51
]
52
},
53
"rateQuantity": {
54
"unit": "ml/min",
55
"value": 90
56
}
57
},
58
"meta": {
59
"lastUpdated": "2022-12-01T22:03:47.989Z"
60
}
61
},
62
"search": {
63
"mode": "match",
64
"score": 1
65
}
66
}
67
],
68
"total": 1
69
}