MedicationStatement _search

post/MedicationStatement/_search

Page View

This resource contains one or more statements about a medication that a patient has taken, is currently taking, or may take in the future. A patient, related person, or clinician may make the statement(s).

The difference between this and MedicationAdministration is that MedicationStatement contains informal statements rather than official administration details, such as dosage or date/time of administration. The information likely isn’t as specific, since the statement might come from a patient’s account or a list that a related person may maintain for the patient.

You can review or retrieve a list of medication statements for a patient.

Supported fields

We support any valid FHIR® field. However, we only display the fields that we’ve defined in the schema, which are usually based on what’s included in the U.S. Core profile.

_search

Query for a list of medication statements given by or on behalf of a patient.

This is a flexible option with query parameters to refine your search. The response returns a bundle of resources, known as a searchset bundle type. Learn about bundles and bundle types in our FHIR® glossary.

Request parameters and payload

When querying for this resource, one of the following sets of parameters must always be sent. Additional parameters may be sent at any time.

patient

cURL request example

bash

1
curl 'https://api.redoxengine.com/fhir/R4/{destinationSlug}/{environmentFlag}/MedicationStatement/_search' \
2
--request POST \
3
--header 'Authorization: Bearer $API_TOKEN' \
4
--header 'Content-Type: application/x-www-form-urlencoded' \
5
--data-urlencode 'patient=string' \
6
--data-urlencode 'category=string' \
7
--data-urlencode 'effective=string'

Request Body Schema

patient
Array of string
The patient who is consuming the medication
category
Array of string
The categorization of the Medication Statement
effective
Array of string
The Date when patient was taking (or not taking) the medication

Response fields and example

Example payload generated from schema

1
{
2
  "resourceType": "Bundle",
3
  "type": "searchset",
4
  "total": 1,
5
  "entry": [
6
    {
7
      "resource": {
8
        "resourceType": "MedicationStatement",
9
        "id": "RedoxMedicationStatementCodeExample",
10
        "identifier": [
11
          {
12
            "system": "urn:oid:1.2.840.114350.1.13.12345.1.7.2.798268",
13
            "value": "587232495"
14
          }
15
        ],
16
        "status": "active",
17
        "subject": {
18
          "reference": "Patient/RedoxPatientExampleTimothy"
19
        },
20
        "effectivePeriod": {
21
          "start": "2013-11-11T05:00:00.000Z"
22
        },
23
        "medicationCodeableConcept": {
24
          "coding": [
25
            {
26
              "code": "104894",
27
              "system": "http://www.nlm.nih.gov/research/umls/rxnorm"
28
            },
29
            {
30
              "code": "0378-7732-93",
31
              "system": "http://hl7.org/fhir/sid/ndc"
32
            },
33
            {
34
              "code": "64695",
35
              "system": "urn:oid:2.16.840.1.113883.6.253"
36
            },
37
            {
38
              "code": "50250065007220",
39
              "system": "urn:oid:2.16.840.1.113883.6.68"
40
            },
41
            {
42
              "code": "64695",
43
              "system": "urn:oid:2.16.840.1.113883.6.162"
44
            }
45
          ],
46
          "text": "Ondansetron 4 Mg Po Tbdp"
47
        },
48
        "reasonCode": [
49
          {
50
            "coding": [
51
              {
52
                "code": "422587007",
53
                "system": "http://snomed.info/sct"
54
              }
55
            ],
56
            "text": "Nausea"
57
          }
58
        ],
59
        "dosage": [
60
          {
61
            "text": "one tablet every morning",
62
            "asNeededBoolean": false,
63
            "route": {
64
              "coding": [
65
                {
66
                  "code": "C38288",
67
                  "system": "urn:oid:2.16.840.1.113883.3.26.1.1",
68
                  "display": "Oral"
69
                }
70
              ]
71
            },
72
            "doseAndRate": [
73
              {
74
                "doseQuantity": {
75
                  "value": 4,
76
                  "unit": "mg"
77
                }
78
              }
79
            ],
80
            "timing": {
81
              "repeat": {
82
                "when": [
83
                  "MORN"
84
                ],
85
                "boundsPeriod": {
86
                  "start": "2013-11-11T05:00:00.000Z"
87
                }
88
              }
89
            }
90
          }
91
        ]
92
      },
93
      "search": {
94
        "mode": "match"
95
      }
96
    }
97
  ]
98
}

Response to a MedicationStatement search operation

resourceType
required, string
Identifies the type of the resource
Value: Bundle
type
required, string
Identifies this bundle as a response to a search
Value: searchset
total
required, number
The total number of matches
entry
Array of MedicationStatement or Other
A resource matching the search criteria or related to a matching resource

FHIR® is a registered trademark of Health Level Seven International (HL7) and is used with the permission of HL7. Use of this trademark does not constitute an endorsement of products/services by HL7®.