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:
- MedicationRequest id
- Status
-
Intent
- Details in Implementation Notes sections for reads and searches.
- Reported Boolean
- Medication (contained)
- Patient
- Encounter
- Authored on Date
- Requester
- Dosage Instructions
Terminology Bindings
Contained Medication Bindings
Medication.code |
|
Search
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
- The
intent
parameter only supports the codesorder
andplan
. - The
_revinclude
parameter may be provided once with the valueProvenance:target
. Example:_revinclude=Provenance:target
. - When
_revinclude
is provided in a request, the OAuth2 token must include thepatient/Provenance.read system/Provenance.read
oruser/Provenance.read
scope as applicable.
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.