MedicationRequest

Overview

The MedicationRequest resource represents an order or request for both supply of medication and instructions for administration to a patient. This includes prescriptions, medication orders, and other requests for therapeutic substances.

Resource Schema

Key fields in the MedicationRequest resource:

{
  "resourceType": "MedicationRequest",
  "id": "example-medrequest-123",
  "status": "active",
  "intent": "order",
  "medicationCodeableConcept": {
    "coding": [
      {
        "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
        "code": "197361",
        "display": "Lisinopril 10 MG Oral Tablet"
      }
    ]
  },
  "subject": {
    "reference": "Patient/123456"
  },
  "authoredOn": "2023-07-15",
  "requester": {
    "reference": "Practitioner/789"
  },
  "dosageInstruction": [
    {
      "text": "Take one tablet by mouth once daily",
      "timing": {
        "repeat": {
          "frequency": 1,
          "period": 1,
          "periodUnit": "d"
        }
      }
    }
  ]
}

Operations

The MedicationRequest resource supports Read and Search operations. Support varies by CareRecord solution.

CareRecord / Solution	Read	Search
GEHRIMED	✅	✅
myAvatar	✅	✅
myEvolv	✅	✅
myUnity	✅	✅
TheraOffice	✅	✅

Read

Retrieves a specific MedicationRequest resource by ID.

HTTP Method: GET
URL: /MedicationRequest/{id}

Examples

Production

curl -X GET https://fhir.netsmartcloud.com/uscore/v1/MedicationRequest/123456 \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Preview

curl -X GET https://fhirtest.netsmartcloud.com/uscore/v1/MedicationRequest/123456 \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Search

Retrieves MedicationRequest resources matching specified criteria.

HTTP Method: GET or POST
URL: /MedicationRequest or /MedicationRequest/_search

Search Parameters

Patient-based Search:

Parameter	Type	Required	Description	Example
patient	reference	Yes	REQUIRED Returns prescriptions for a specific patient	patient=value
authoredon	date	No	Return prescriptions written on this date	authoredon=value
encounter	reference	No	Returns prescriptions with this encounter identifier	encounter=value
intent	token	No	Returns prescriptions with different intents	intent=value
page	string	No	Zero-based page index	page=value
status	token	No	Status of the prescription	status=value
_revinclude	special	No	Include Provenance resource(s) that reference the matched search results. Allowed: "Provenance:target"	_revinclude=value

ID-based Search:

Parameter	Type	Required	Description	Example
authoredon	date	No	Return prescriptions written on this date	authoredon=value
encounter	reference	No	Returns prescriptions with this encounter identifier	encounter=value
intent	token	No	Returns prescriptions with different intents	intent=value
page	string	No	Zero-based page index	page=value
status	token	No	Status of the prescription	status=value
_revinclude	special	No	Include Provenance resource(s) that reference the matched search results. Allowed: "Provenance:target"	_revinclude=value

Examples

POST Method (Recommended)

Production

Search by Patient

curl -X POST https://fhir.netsmartcloud.com/uscore/v1/MedicationRequest/_search \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json" \
    -H "Content-Type: application/x-form-urlencoded" \
    -d "patient=Patient/123" \
    -d "intent=order"

Preview

Search by Patient

curl -X POST https://fhirtest.netsmartcloud.com/uscore/v1/MedicationRequest/_search \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json" \
    -H "Content-Type: application/x-form-urlencoded" \
    -d "patient=Patient/123" \
    -d "intent=order"

GET Method

Production

Search by Patient

curl -X GET "https://fhir.netsmartcloud.com/uscore/v1/MedicationRequest?patient=Patient/123&intent=order" \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Preview

Search by Patient

curl -X GET "https://fhirtest.netsmartcloud.com/uscore/v1/MedicationRequest?patient=Patient/123&intent=order" \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Integration Patterns

Common Workflows

1. Medication History - Retrieve all medication requests for a patient
2. Active Prescriptions - Search by status for current medications
3. Prescription Verification - Check medication orders before dispensing

Relationships to Other Resources

The MedicationRequest resource relates to:

• Patient - Subject of the medication request
• Practitioner - Who prescribed the medication
• Encounter - Healthcare encounter when medication was prescribed
• AllergyIntolerance - Allergies that may affect medication choice

Error Handling

For common errors and troubleshooting guidance, see Common Errors.

Supported Profiles

Profiles supported by this resource (as defined in the CapabilityStatement):

• HL7 FHIR R4 MedicationRequest
• US Core MedicationRequest