MedicationRequest

Top  Previous  Next

An order or request for both supply of the medication and the instructions for administration of the medication to a patient.

 

Response Description

Sample Response

{

 "resourceType": "MedicationRequest",

 "id": "DEV-DEV-11913-26708",

 "meta": {

       "lastUpdated": "2022-11-17T12:00:00-05:00",

 "profile": [

 "http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest"

 ]

   },

 "text": {

 "status": "generated",

 "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><table><tbody><tr><td>Patient:</td><td>Cole Andersonian, Sr. (DEV-DEV-11913)</td></tr><tr><td>Brand Name:</td><td>Tylenol PM Pill</td></tr><tr><td>Generic Name:</td><td>acetaminophen</td></tr><tr><td>RxNorm Code:</td><td>1187314</td></tr><tr><td>Start Date:</td><td>11/01/2021</td></tr><tr><td>Stop Date:</td><td>11/17/2022</td></tr><tr><td>Patient Notes:</td><td>Takes 1-2 tablets once daily at bedtime as needed for restless legs</td></tr></tbody></table></div>"

 },

 "status": "completed",

 "intent": "plan",

 "reportedBoolean": false,

 "authoredOn": "2021-11-01",

 "subject": {

       "reference": "Patient/DEV-DEV-11913",

 "display": "Cole Andersonian, Sr. (DEV-DEV-11913)"

    },

 "medicationCodeableConcept": {

       "coding": [

 {

 "system": "http://www.nlm.nih.gov/research/umls/rxnorm",

 "code": "1187314",

 "display": "Tylenol PM Pill"

    }

   ]

  },

 "dosageInstruction": [

       {

 "text": "no information available"

    }

   ],

 "encounter": {

 "reference": "Encounter/DEV-DEV-11913-0014792",

 "display": "10/25/2022 at 7:00 am, Blood Pressure Visit with provider 117 at location OF1"

    },

 "requester": {

 "reference": "Patient/DEV-DEV-11913",

 "display": "Cole Andersonian, Sr. (DEV-DEV-11913)"

    },

 "note": [

 {

 "text": "Takes 1-2 tablets once daily at bedtime as needed for restless legs"

    }

  ]

}

 

MedicationRequest.id

 

The logical ID of the resource, as used in the URL for the resource. Once assigned, this value never changes.

Cardinality

0..1

Type

string

 

 

MedicationRequest.meta

 

Metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.

Cardinality

0..1

Type

Meta

 

 

MedicationRequest.text

 

A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative.

Cardinality

0..1

Type

Narrative

Comment

Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.

 

 

MedicationRequest.status

 

A code specifying the current state of the MedicationRequest. Generally, this will be active or completed state.

Cardinality

1..1

Type

code: Medicationrequest status

active | on-hold | cancelled | completed | entered-in-error | stopped | draft | unknown

 

 

MedicationRequest.intent

 

A code specifying the intent of the MedicationRequest. Generally this will be plan or order.

Cardinality

1..1

Type

code: Medicationrequest intent

proposal | plan | order | original-order | reflex-order | filler-order | instance-order | option

 

 

MedicationRequest.reportedBoolean

 

Indicates if this record was captured as a secondary 'reported' record rather than as an original primary source-of-truth record.

Cardinality

0..1

Type

boolean

 

 

MedicationRequest.authoredOn

 

The date when the prescription was initially written or authored on.

Cardinality

0..1

Type

dateTime

 

 

MedicationRequest.subject

 

A link to a resource representing the person or set of individuals to whom the medication will be given.

Cardinality

1..1

Type

Reference(Patient)

 

 

MedicationRequest.medicationCodeableConcept

 

Identifies the medication being requested.

Cardinality

1..1

Type

CodeableConcept SNOMED CT Medication Codes

Comment

If only a code is specified, then it needs to be a code for a specific product. If more information is required, then the use of the Medication resource is recommended. For example, if you require form or lot number or if the medication is compounded or extemporaneously prepared, then you must reference the Medication resource.

 

 

MedicationRequest.dosageInstruction

 

Indicates how the medication is to be used by the patient.

Cardinality

0..*

Type

Dosage

Comment

There are examples where a medication request may include the option of an oral dose or an Intravenous or Intramuscular dose

 

 

MedicationRequest.dosageInstruction.text

 

Free text dosage instructions e.g. SIG.

Cardinality

0..1

Type

string

Requirements

Free text dosage instructions can be used for cases where the instructions are too complex to code.

 

 

MedicationRequest.encounter

 

The Encounter which the creation of this record is tightly associated.

Cardinality

0..1

Type

Reference(Encounter)

 

 

MedicationRequest.requester

 

The individual, organization, or device that initiated the request and has responsibility for its activation.

Cardinality

0..1

Type

Reference(Patient)

 

 

MedicationRequest.note

 

Extra information about the prescription that could not be conveyed by the other attributes

Cardinality

0..*

Type

Annotation

 


 

Search

 

URL Syntax

Two HTTP methods are supported for searching: GET and POST. It is recommended to use HTTP POST.

Visit the FHIR Sandbox to try requests.

 

 

HTTP GET - searching

https://sandbox.pai.healthcare/preview/fhir/MedicationRequest?{query string}

 

HTTP GET - return single record

https://sandbox.pai.healthcare/preview/fhir/MedicationRequest/{resource id}

 

HTTP POST - searching

https://sandbox.pai.healthcare/preview/fhir/MedicationRequest/_search

Set the Content-Type header to application/x-www-urlencoded

The body of the request is a similar query string used in the GET type of request detailed above.

 

 

Error Handling

If no records are returned or invalid search parameters are provided, then an HTTP 400 Bad Request is returned.

The body of the response will be an OperationOutcome.

 

 

Supported Search Parameters

 

_id

Corresponds to

MedicationRequest.id

Search

exact

Example

https://sandbox.pai.healthcare/preview/fhir/MedicationRequest/DEV-DEV-11913-26702

https://sandbox.pai.healthcare/preview/fhir/MedicationRequest?_id=DEV-DEV-11913-26702

 

 

Returns the MedicationRequest for account 11913 in the dev practice where the table ID is 26702.

 

patient

Corresponds to

MedicationRequest.subject

Search

exact

Example

https://sandbox.pai.healthcare/preview/fhir/MedicationRequest?patient=Patient/dev-dev-11913

 

Returns all MedicationRequests for the 11913 account in the dev practice

 

encounter

Corresponds to

MedicationRequest.encounter

Search

exact

Example

https://sandbox.pai.healthcare/preview/fhir/MedicationRequest?patient=Patient/DEV-DEV-11913-0014796

 

Returns MedicationRequest for accession# 0014796 for account 11913.

 

patient + intent

Corresponds to

MedicationRequest.subject + MedicationRequest.intent

Search

exact

Example

https://sandbox.pai.healthcare/preview/fhir/MedicationRequest?patient=Patient/DEV-DEV-11913&intent=order

 

Returns all MedicationRequests for patient 11913 with an order intent.

 

patient + intent + status

Corresponds to

MedicationRequest.subject + MedicationRequest.intent + MedicationRequest.status

Search

exact

Example

https://sandbox.pai.healthcare/preview/fhir/MedicationRequest?patient=Patient/DEV-DEV-11913&intent=plan&status=active

 

Returns MedicationRequests with a status of active and a plan intent for patient 11913.

 

patient + intent + encounter

Corresponds to

MedicationRequest.subject + MedicationRequest.intent + MedicationRequest.encounter

Search

exact

Example

https://sandbox.pai.healthcare/preview/fhir/MedicationRequest?patient=Patient/DEV-DEV-11913&intent=plan,order&encounter=DEV-DEV-11913-0014796

 

Returns MedicationRequest with an intent of plan for accession# 0014796 for patient 11913.