Implementation Guide (Release 1.2.0)

US_Meds, published by HL7 International - Pharmacy Work Group. This is not an authorized publication; it is the continuous build for version 1.2.0). This version is based on the current content of https://github.com/HL7/FHIR-ONC-Meds/ and changes regularly. See the Directory of published versions

Get All Active Medications

Storyboard for this example

The following example is based upon the following scenario:

Patient Brian Z uses an App to request all his medications from a single provider, Dr Cayr. This test scenario exercises a mix of routine meds, unusual schedule meds and as-needed meds. All meds are in the outpatient setting only.

Provider A’s (Dr Cayr) medication records for Patient Brian Z

Item Date Script Source Notes
1 9/12/2016 testosterone cypionate 100mg/ml inj 1ml intramuscularly every 3 weeks Reported by Patient Get at doctor’s office every third Friday. Taking for energy level and drive.
2 9/1/2016 testosterone cypionate 100mg/ml inj 1ml intramuscularly Reported by Dr Cryn completed
3 1/15/2016 Zocor (simvastatin) 40mg by mouth once daily Dr. Cayr Order: BMC patient med status: taking
4 7/1/2015 Humulin R (insulin regular, human) U100 10U every AM, 5U every PM, 5U at bedtime. Dr.Cayr Order:BMC patient med status: taking
5 6/12/2015 simvastatin 30mg by mouth once daily Dr. Cayr Order: BMC patient med status: completed

Request:

Get “all active medications” for a patient by querying MedicationStatement using the patient and status= “active” search parameters.

GET [base]/MedicationStatement?patient=test2&status=active

Response:

A Server returns a search Bundle resource containing all the MedicationStatements with a status of “active” for the patient Brian Z

HTTP/1.1 200 OK
[other headers]
{
"resourceType" : "Bundle",
"id" : "get-all-meds",
"meta" : {
  "lastUpdated" : "2017-03-28T14:29:23Z"
},
"type" : "searchset",
"total" : 4,
"entry" : [
  {
    "fullUrl" : "http://fhir3.healthintersections.com.au/open/MedicationStatement/derivedfrom-mr-test2-1",
    "resource" : {
      "resourceType" : "MedicationStatement",
      "id" : "derivedfrom-mr-test2-1",
...snip...
      "status" : "active",
      "medicationCodeableConcept" : {
        "coding" : [
          {
            "system" : "http://www.nlm.nih.gov/research/umls/rxnorm",
            "code" : "104491",
            "display" : "Simvastatin 20 MG Oral Tablet [Zocor]",
            "userSelected" : false
          }
        ],
        "text" : "Zocor (simvastatin) 20mg Tablet"
      },
...snip...
  },
  {
    "fullUrl" : "http://fhir3.healthintersections.com.au/open/MedicationStatement/derivedfrom-mr-test2-2",
    "resource" : {
      "resourceType" : "MedicationStatement",
      "id" : "derivedfrom-mr-test2-2",
...snip...
      "status" : "active",
      "medicationCodeableConcept" : {
        "coding" : [
          {
            "system" : "http://www.nlm.nih.gov/research/umls/rxnorm",
            "code" : "311036",
            "display" : "Humulin R (insulin regular, human) U100  100units/ml inj solution",
            "userSelected" : false
          }
        ],
        "text" : "Humulin R (insulin regular, human) U100  100units/ml inj solution"
      },
...snip...
  },
  {
    "fullUrl" : "http://fhir3.healthintersections.com.au/open/MedicationStatement/test2-2",
    "resource" : {
      "resourceType" : "MedicationStatement",
      "id" : "test2-2",
...snip...
      "status" : "active",
      "medicationCodeableConcept" : {
        "coding" : [
          {
            "system" : "http://www.nlm.nih.gov/research/umls/rxnorm",
            "code" : "835829",
            "display" : "testosterone cypionate 100 MG/ML Injectable Solution",
            "userSelected" : false
          }
        ],
        "text" : "testosterone cypionate 100mg/ml inj"
      },
...snip...
    }
  }
 ]
}

links to example files: