MedicationRequest

Overview

The MedicationRequest resource provides discharge medication orders and administration instructions for a patient in the context of a visit.

Soarian Clinicals® supports a read-only Application Programming Interface (API). This API accepts GET and POST based search and GET based read interactions. The response represents the most current information about the patient that is charted in Soarian Clinicals® at the time of the query.

The search results include the following fields if they contain values:

Terminology Bindings

Contained Medication Bindings

Medication.code
  • Description
    • A code that defines the medication
  • Details: RxNorm
    System: https://www.nlm.nih.gov/research/umls/rxnorm

Search for MedicationRequest resources that meet the specified query parameters.

GET /MedicationRequest?:parameters

Authorization Types

Parameters

Name Required? Type Description
_id This, or patient token The logical resource ID associated with the resource.
patient This, or _id reference The patient who has the medication request.
status No token The status of the medication request. May be a list separated by commas.
intent No token The kind of medication order. May be a list separated by commas.
encounter This, or _id reference The encounter associated with the medication request.
_revinclude No _revinclude A request to include any Provenance resource in the bundle that refers to a MedicationRequest resource in the search results. Only supported with Provenance.

Notes

Headers

Accept: application/fhir+json
Authorization: <OAuth2 Bearer Token>

Example Search by Patient

Request

GET https://fhir-myrecord-sc.sandboxcerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/MedicationRequest?patient=A879904FD2FE4B2D90C89FDA84E1285F

Response

Status: 200 OK
{
  "resourceType": "Bundle",
  "id": "cde6e0c8-cb24-4a90-ae0e-b4b3042f3638",
  "type": "searchset",
  "timestamp": "2022-05-11T04:42:40-04:00",
  "entry": [
    {
      "fullUrl": "https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/MedicationRequest/A879904FD2FE4B2D90C89FDA84E1285F.17864",
      "search": {
        "mode": "match"
      },
      "resource": {
        "resourceType": "MedicationRequest",
        "id": "A879904FD2FE4B2D90C89FDA84E1285F.17864",
        "meta": {
          "lastUpdated": "2021-05-19T12:43:34-04:00"
        },
        "medicationReference": {
          "reference": "#17864"
        },
        "contained": [
          {
            "resourceType": "Medication",
            "id": "17864",
            "code": {
              "coding": [
                {
                  "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                  "code": "213469",
                  "display": "celecoxib 200 MG Oral Capsule [Celebrex]"
                },
                {
                  "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                  "code": "205323",
                  "display": "celecoxib 200 MG Oral Capsule"
                }
              ],
              "text": "celecoxib"
            }
          }
        ],
        "status": "active",
        "intent": "plan",
        "reportedBoolean": false,
        "subject": {
          "reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
          "display": "Mcgovern,Astrid Santiago"
        },
        "encounter": {
          "reference": "Encounter/A879904FD2FE4B2D90C89FDA84E1285F.29019",
          "display": "Inferno,Initial"
        },
        "authoredOn": "2021-05-19T12:43:33-04:00",
        "requester": {
          "reference": "Practitioner/40134EF110CA4C07988F544E90057844"
        },
        "dosageInstruction": [
          {
            "text": "celecoxib  (CeleBREX)  200 mg  Capsule  Directions: 1 capsule  oral  daily  Continued By: Admin  Admin "
          }
        ],
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>MedicationRequest</b><br /><b>Patient</b>:Mcgovern,Astrid Santiago;<br /><b>Encounter</b>:Inferno,Initial;<br /><b>Status</b>:active;<br /><b>Intent</b>:plan;<br /><b>Medication</b>:<br /><b>System</b>:http://www.nlm.nih.gov/research/umls/rxnorm <b>Code</b>:213469 <b>Display</b>:celecoxib 200 MG Oral Capsule [Celebrex] <b>Text</b>:celecoxib;<br /><b>System</b>:http://www.nlm.nih.gov/research/umls/rxnorm <b>Code</b>:205323 <b>Display</b>:celecoxib 200 MG Oral Capsule <b>Text</b>:celecoxib;<br /><b>Authored On</b>:2021-05-19T12:43:33-04:00;<br /><b>Dosage Instructions</b>:celecoxib  (CeleBREX)  200 mg  Capsule  Directions: 1 capsule  oral  daily  Continued By: Admin  Admin ;<br /></div>"
        }
      }
    }
  ],
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-myrecord-sc.sandboxcerner.com/r4/3f2aca24-87f3-4eac-a6d7-1f75247e6b43/MedicationRequest?patient=A879904FD2FE4B2D90C89FDA84E1285F"
    }
  ]
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Example Search by ID

Request

GET https://fhir-myrecord-sc.sandboxcerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/MedicationRequest?_id=A879904FD2FE4B2D90C89FDA84E1285F.17864

Response

Status: 200 OK
{
  "resourceType": "Bundle",
  "id": "cde6e0c8-cb24-4a90-ae0e-b4b3042f3638",
  "type": "searchset",
  "timestamp": "2022-05-11T04:42:40-04:00",
  "entry": [
    {
      "fullUrl": "https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/MedicationRequest/A879904FD2FE4B2D90C89FDA84E1285F.17864",
      "search": {
        "mode": "match"
      },
      "resource": {
        "resourceType": "MedicationRequest",
        "id": "A879904FD2FE4B2D90C89FDA84E1285F.17864",
        "meta": {
          "lastUpdated": "2021-05-19T12:43:34-04:00"
        },
        "medicationReference": {
          "reference": "#17864"
        },
        "contained": [
          {
            "resourceType": "Medication",
            "id": "17864",
            "code": {
              "coding": [
                {
                  "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                  "code": "213469",
                  "display": "celecoxib 200 MG Oral Capsule [Celebrex]"
                },
                {
                  "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                  "code": "205323",
                  "display": "celecoxib 200 MG Oral Capsule"
                }
              ],
              "text": "celecoxib"
            }
          }
        ],
        "status": "active",
        "intent": "plan",
        "reportedBoolean": false,
        "subject": {
          "reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
          "display": "Mcgovern,Astrid Santiago"
        },
        "encounter": {
          "reference": "Encounter/A879904FD2FE4B2D90C89FDA84E1285F.29019",
          "display": "Inferno,Initial"
        },
        "authoredOn": "2021-05-19T12:43:33-04:00",
        "requester": {
          "reference": "Practitioner/40134EF110CA4C07988F544E90057844"
        },
        "dosageInstruction": [
          {
            "text": "celecoxib  (CeleBREX)  200 mg  Capsule  Directions: 1 capsule  oral  daily  Continued By: Admin  Admin "
          }
        ],
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>MedicationRequest</b><br /><b>Patient</b>:Mcgovern,Astrid Santiago;<br /><b>Encounter</b>:Inferno,Initial;<br /><b>Status</b>:active;<br /><b>Intent</b>:plan;<br /><b>Medication</b>:<br /><b>System</b>:http://www.nlm.nih.gov/research/umls/rxnorm <b>Code</b>:213469 <b>Display</b>:celecoxib 200 MG Oral Capsule [Celebrex] <b>Text</b>:celecoxib;<br /><b>System</b>:http://www.nlm.nih.gov/research/umls/rxnorm <b>Code</b>:205323 <b>Display</b>:celecoxib 200 MG Oral Capsule <b>Text</b>:celecoxib;<br /><b>Authored On</b>:2021-05-19T12:43:33-04:00;<br /><b>Dosage Instructions</b>:celecoxib  (CeleBREX)  200 mg  Capsule  Directions: 1 capsule  oral  daily  Continued By: Admin  Admin ;<br /></div>"
        }
      }
    }
  ],
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/MedicationRequest?patient=A879904FD2FE4B2D90C89FDA84E1285F"
    }
  ]
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Errors

The common errors and OperationOutcomes may be returned.

Retrieve by ID

List an individual MedicationRequest resource by its ID:

GET /MedicationRequest/:id

Authorization Types

Headers

Accept: application/fhir+json
Authorization: <OAuth2 Bearer Token>

Example

Request

GET https://fhir-myrecord-sc.sandboxcerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/MedicationRequest/A879904FD2FE4B2D90C89FDA84E1285F.17864

Response

Status: 200 OK
{
  "resourceType": "MedicationRequest",
  "id": "A879904FD2FE4B2D90C89FDA84E1285F.17864",
  "meta": {
    "lastUpdated": "2021-05-19T12:43:34-04:00"
  },
  "medicationReference": {
    "reference": "#17864"
  },
  "contained": [
    {
      "resourceType": "Medication",
      "id": "17864",
      "code": {
        "coding": [
          {
            "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
            "code": "213469",
            "display": "celecoxib 200 MG Oral Capsule [Celebrex]"
          },
          {
            "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
            "code": "205323",
            "display": "celecoxib 200 MG Oral Capsule"
          }
        ],
        "text": "celecoxib"
      }
    }
  ],
  "status": "active",
  "intent": "plan",
  "reportedBoolean": false,
  "subject": {
    "reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
    "display": "Mcgovern,Astrid Santiago"
  },
  "encounter": {
    "reference": "Encounter/A879904FD2FE4B2D90C89FDA84E1285F.29019",
    "display": "Inferno,Initial"
  },
  "authoredOn": "2021-05-19T12:43:33-04:00",
  "requester": {
    "reference": "Practitioner/40134EF110CA4C07988F544E90057844"
  },
  "dosageInstruction": [
    {
      "text": "celecoxib  (CeleBREX)  200 mg  Capsule  Directions: 1 capsule  oral  daily  Continued By: Admin  Admin "
    }
  ],
  "text": {
    "status": "generated",
    "div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>MedicationRequest</b><br /><b>Patient</b>:Mcgovern,Astrid Santiago;<br /><b>Encounter</b>:Inferno,Initial;<br /><b>Status</b>:active;<br /><b>Intent</b>:plan;<br /><b>Medication</b>:<br /><b>System</b>:http://www.nlm.nih.gov/research/umls/rxnorm <b>Code</b>:213469 <b>Display</b>:celecoxib 200 MG Oral Capsule [Celebrex] <b>Text</b>:celecoxib;<br /><b>System</b>:http://www.nlm.nih.gov/research/umls/rxnorm <b>Code</b>:205323 <b>Display</b>:celecoxib 200 MG Oral Capsule <b>Text</b>:celecoxib;<br /><b>Authored On</b>:2021-05-19T12:43:33-04:00;<br /><b>Dosage Instructions</b>:celecoxib  (CeleBREX)  200 mg  Capsule  Directions: 1 capsule  oral  daily  Continued By: Admin  Admin ;<br /></div>"
  }
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Errors

The common errors and OperationOutcomes may be returned.