MedicationRequest

An order or request for both supply of the medication and the instructions for administration of the medication to a patient. The resource is called "MedicationRequest" rather than "MedicationPrescription" or "MedicationOrder" to generalize the use across inpatient and outpatient settings, including care plans, etc., and to harmonize with workflow patterns.

Definition

MedicationRequest Resource

Get/Read

The [patient|user|system]/MedicationRequest.r authorization scope is required.

Required Parameters

Name Description DataType
ID The id for the Medication Request Resource. Token

Result Components

Name Description
MedicationRequest.status Code
MedicationRequest.intent Code
MedicationRequest.category CodeableConcept
MedicationRequest.reported Boolean | Reference (Practitioner)
MedicationRequest.medication CodeableConcept | Reference (Medication)
MedicationRequest.subject Reference (Patient)
MedicationRequest.encounter Reference (Encounter)
MedicationRequest.authoredOn DateTime
MedicationRequest.requester Reference (Practitioner)
MedicationRequest.dosageInstruction.text String

Response Codes

Response Code Description
200 OK The requested MedicationRequest resource was found and is contained within the body of the HTTP response.
400 Bad Request The server could not understand the request due to invalid syntax.
404 Not Found The requested resource does not exist.
500 Internal Server Error The server has encountered a situation it doesn't know how to handle, resulting in an error.

Example GET syntax of ResourceID 24:

GET https://webservices.systemedx.com/xnet/api/fhir/MedicationRequest/24

This would return a Resource like the one below.

{
    "resourceType": "MedicationRequest",
    "id": "24",
    "status": "Active",
    "intent": "Order"
    "category": [
         {
            "coding": [
                 {
                    "system": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-medicationrequest",
                    "code": "community",
                 }
            ]
         },
        {
             "coding": [
                 {
                    "system": "http://www.nlm.nih.gov/research/umls/rxnorm"",
                 }
              ]
         }
    ],
    "priority": "rountine"
    "reportedBoolean": "false"
    "medicationReference: {
                "reference": "https://localhost:44391/fhir/Medication/24",
    },
    "subject": {
    "reference": "https://localhost:44391/fhir/Patient/66"",
    "display": "Peter Rice"
    },
    "encounter": {
        "extension": [ 
         {
             "url" : :http://hl7.org/fhir/StructureDefinition/data-absent-reason,
             "valueCode": "unknown"
          }
        ]
    },
    "authoredOn": "2014-09-10T00:00:00-05:00",
    "reference": "https://localhost:44391/fhir/Practitioner/NM-SMX"
    },
    "dosageInstruction": [
    {
            "text": "1 Tablet by mouth 1 time per day",
            "doseAndRate": [
                {
                    "doseQuantity": {
                        "value": 1,
                        "unit": "Unknown"
                    }
                }
            ]
        }
    ]
}               

Search/Post

The [patient|user|system]/MedicationRequest.rs authorization scope is required.

The following additional authorization scopes might be required depending on _include and/or _revinclude search parameters used:

Required & Optional Parameters

Name Description DataType
patient Returns prescriptions for a specific patient. Reference
intent Returns prescriptions with different intents Token
status Status of the prescription Token

Example SEARCH syntax of MedicationRequest for Patientid 66:

GET https://webservices.systemedx.com/xnet/api/fhir/MedicationRequest?patient=66&intent=order,plan&status=active

This would return a bundle containing one or more MedicationRequest Resources like the one above.