MedicationRequest

Medications - The MedicationRequest resource provides orders for all medications along with administration instructions for a patient in both the inpatient and outpatient setting (orders/prescriptions filled by a pharmacy and discharge medication orders). This resource also includes a patient's historical or documented home medications reported by the patient, significant other or another provider.

General Information

The connectivity of this FHIR endpoint is as follows:

HTTP Method
GET, POST
Supported OAuth 2.0 User Types
Backend Systems, Clinicians or Administrative Users, Patients
Profiles Supported
  • Us Core Medicationrequest
  • Request Parameters

    The following fields and datatypes are the parameters for the request string. All fields are optional, however if no settings are set, all values will be exported up to the maximum count of 100

    Name (type) Description (bindings)
    _id
    (token)
    A single or comma separated list of MedicationRequest ids. It is a required field if the patient field is not given.
    patient
    (reference)
    Who the medicationrequest is for. It is a required field if the _id field is not given.
    _count
    (number)
    The maximum number of results to return in a page. Not honored when '_id' is set.
    date
    (date)
    A date or date range from which to find medicationrequest. The 'date' parameter may be provided once without a prefix or time component to imply a date range or once without a prefix and with a time component to search for medicationrequest at a specific time. Alternately it may be provided twice with 'le' and 'gt' prefixes to search for medicationrequest within a specific range. The date prefix pair must create a closed range.
    status
    (token)
    The overall status of the medicationrequest.
    _pretty
    (boolean)
    set to false to disable formatted output.
    _revinclude
    (static)
    _revinclude parameter may be provided once with the value Provenance:target to pull the relevant Provenance information. Example: _revinclude=Provenance:target
    intent
    (token)
    The intent of the MedicationRequest.
    authoredon
    (date)
    The authored date of the MedicationRequest.
    _include
    (static)
    include parameter may be provided once with the value MedicationRequest:medication to access relevant medication resources. Example: include=MedicationRequest:medication

    Returned Data Fields

    The following fields and bindings are returned if valued

    Field (type) Description (bindings) Opt?
    id
    (Id)
    Id
    subject
    (Reference)
    Reference to a patient resource for whom the report is relevant
    requester
    (Reference)
    Reference to a requestor resource for whom the report is relevant, generally patient
    encounter
    (Reference)
    Reference to a encounter resource for whom the report is relevant
    status
    (String)
    Indicates the current status of the MedicationRequest event.

    Medication Request Status Reason Codes (https://hl7.org/fhir/ValueSet/medicationrequest-status-reason)
    authoredOn
    (DateTime)
    Date original order was placed
    medication_x_
    (CodeableConcept)
    Standarized RxNorm(c) Coding For Medication

    RxNorm (http://www.nlm.nih.gov/research/umls/rxnorm)
    dosageInstruction
    (Dosage)
    Indicates how the medication is to be used by the patient.

    Default Patient Query

    The following are live queries representative of a data request on our sandbox environment.

    Headers

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

    Request

    GET https://portal.viewmymed.com/fhir/MedicationRequest?patient=99999.122753-00&_count=1

    HTTP/1.0 200 OK
    Cache-Control: no-cache, private
    Content-Type:  application/fhir+json
    Date:          Mon, 02 Feb 2026 06:42:10 GMT
    Etag:          W/"1"
    
    {
        "resourceType": "Bundle",
        "id": "6980474215cec6980474215ced",
        "type": "searchset",
        "link": [
            {
                "relation": "self",
                "url": "https://portal.viewmymed.com/api/MedicationRequest"
            }
        ],
        "entry": [
            {
                "fullUrl": "https://portal.viewmymed.com/fhir/MedicationRequest/ba4723d75d63a55f1ada30a64899175d",
                "resource": {
                    "resourceType": "MedicationRequest",
                    "id": "ba4723d75d63a55f1ada30a64899175d",
                    "meta": {
                        "versionId": "ba4723d75d63a55f1ada30a64899175d",
                        "lastUpdated": "2023-01-26T06:33:04+00:00"
                    },
                    "status": "active",
                    "intent": "order",
                    "text": {
                        "status": "generated",
                        "div": "

    Name: Compression Socks, Large

    \n

    Start Date: / /

    \n

    Completion Date:

    \n

    SIG: 1 PO once a day

    \n

    Status: order

    \n

    Prescriber: Howard R. Fenderson

    \n
    " }, "subject": { "reference": "Patient/99997.122753-00" }, "requester": { "reference": "Patient/99997.122753-00" }, "encounter": { "reference": "Encounter/fb9f088c689044da7a617c6ae144be05" }, "reportedBoolean": false, "authoredOn": "2023-01-26T06:33:04+00:00", "medicationCodeableConcept": { "coding": [ { "system": "http://www.nlm.nih.gov/research/umls/rxnorm", "code": "554387", "display": "Compression Socks, Large" } ], "text": "Compression Socks, Large" }, "dosageInstruction": [ { "sequence": 1, "text": "1 PO once a day" } ] } } ] }

    Error Codes / Outcomes

    All endpoints share the same error codes and common outcomes.