RequestGroup - FHIR Resource (r4)


This RequestGroup Resource uses the FHIR API standard for access and structure.

Validate an RequestGroup FHIR Resource (r4)



Resource Attributes

AttributeField is listTypeDescription
actiontrueData Type# Proposed actions, if any
authorfalseReference# Device or practitioner that authored the request group
authoredOnfalsedateTime# When the request group was authored
basedOntrueReference# Fulfills plan, proposal, or order
codefalseCodeableConcept# What's being requested/ordered
encounterfalseReference# Created as part of
groupIdentifierfalseIdentifier# Composite request this is part of
identifiertrueIdentifier# Business identifier
instantiatesCanonicaltruecanonical# Instantiates FHIR protocol or definition
instantiatesUritrueuri# Instantiates external protocol or definition
intentfalsecode# proposal | plan | directive | order | original-order | reflex-order | filler-order | instance-order | option
notetrueAnnotation# Additional notes about the response
priorityfalsecode# routine | urgent | asap | stat
reasonCodetrueCodeableConcept# Why the request group is needed
reasonReferencetrueReference# "reasonReference" : [{ Reference(Condition|Observation|DiagnosticReport|
replacestrueReference# Request(s) replaced by this request
statusfalsecode# draft | active | on-hold | revoked | completed | entered-in-error | unknown
subjectfalseReference# Who the request group is about

RequestGroup Example

{
  "resourceType": "RequestGroup",
  "id": "example",
  "text": {
    "status": "generated",
    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Example RequestGroup illustrating related actions to administer medications in sequence with time delay.</div>"
  },
  "contained": [
    {
      "resourceType": "MedicationRequest",
      "id": "medicationrequest-1",
      "status": "unknown",
      "intent": "proposal",
      "medicationCodeableConcept": {
        "text": "Medication 1"
      },
      "subject": {
        "reference": "Patient/example"
      }
    },
    {
      "resourceType": "MedicationRequest",
      "id": "medicationrequest-2",
      "status": "unknown",
      "intent": "proposal",
      "medicationCodeableConcept": {
        "text": "Medication 2"
      },
      "subject": {
        "reference": "Patient/example"
      }
    }
  ],
  "identifier": [
    {
      "value": "requestgroup-1"
    }
  ],
  "groupIdentifier": {
    "system": "http://example.org/treatment-group",
    "value": "00001"
  },
  "status": "draft",
  "intent": "plan",
  "priority": "routine",
  "subject": {
    "reference": "Patient/example"
  },
  "encounter": {
    "reference": "Encounter/example"
  },
  "authoredOn": "2017-03-06T17:31:00Z",
  "author": {
    "reference": "Practitioner/1"
  },
  "reasonCode": [
    {
      "text": "Treatment"
    }
  ],
  "note": [
    {
      "text": "Additional notes about the request group"
    }
  ],
  "action": [
    {
      "prefix": "1",
      "title": "Administer Medications",
      "description": "Administer medications at the appropriate time",
      "textEquivalent": "Administer medication 1, followed an hour later by medication 2",
      "timingDateTime": "2017-03-06T19:00:00Z",
      "participant": [
        {
          "reference": "Practitioner/1"
        }
      ],
      "groupingBehavior": "logical-group",
      "selectionBehavior": "all",
      "requiredBehavior": "must",
      "precheckBehavior": "yes",
      "cardinalityBehavior": "single",
      "action": [
        {
          "id": "medication-action-1",
          "description": "Administer medication 1",
          "type": {
            "coding": [
              {
                "code": "create"
              }
            ]
          },
          "resource": {
            "reference": "#medicationrequest-1"
          }
        },
        {
          "id": "medication-action-2",
          "description": "Administer medication 2",
          "relatedAction": [
            {
              "actionId": "medication-action-1",
              "relationship": "after-end",
              "offsetDuration": {
                "value": 1,
                "unit": "h"
              }
            }
          ],
          "type": {
            "coding": [
              {
                "code": "create"
              }
            ]
          },
          "resource": {
            "reference": "#medicationrequest-2"
          }
        }
      ]
    }
  ]
}

RequestGroup Structure

{
  "resourceType" : "RequestGroup",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Business identifier
  "instantiatesCanonical" : ["<canonical>"], // Instantiates FHIR protocol or definition
  "instantiatesUri" : ["<uri>"], // Instantiates external protocol or definition
  "basedOn" : [{ Reference(Any) }], // Fulfills plan, proposal, or order
  "replaces" : [{ Reference(Any) }], // Request(s) replaced by this request
  "groupIdentifier" : { Identifier }, // Composite request this is part of
  "status" : "<code>", // R!  draft | active | on-hold | revoked | completed | entered-in-error | unknown
  "intent" : "<code>", // R!  proposal | plan | directive | order | original-order | reflex-order | filler-order | instance-order | option
  "priority" : "<code>", // routine | urgent | asap | stat
  "code" : { CodeableConcept }, // What's being requested/ordered
  "subject" : { Reference(Patient|Group) }, // Who the request group is about
  "encounter" : { Reference(Encounter) }, // Created as part of
  "authoredOn" : "<dateTime>", // When the request group was authored
  "author" : { Reference(Device|Practitioner|PractitionerRole) }, // Device or practitioner that authored the request group
  "reasonCode" : [{ CodeableConcept }], // Why the request group is needed
  "reasonReference" : [{ Reference(Condition|Observation|DiagnosticReport|
   DocumentReference) }], // Why the request group is needed
  "note" : [{ Annotation }], // Additional notes about the response
  "action" : [{ // Proposed actions, if any
    "prefix" : "<string>", // User-visible prefix for the action (e.g. 1. or A.)
    "title" : "<string>", // User-visible title
    "description" : "<string>", // Short description of the action
    "textEquivalent" : "<string>", // Static text equivalent of the action, used if the dynamic aspects cannot be interpreted by the receiving system
    "priority" : "<code>", // routine | urgent | asap | stat
    "code" : [{ CodeableConcept }], // Code representing the meaning of the action or sub-actions
    "documentation" : [{ RelatedArtifact }], // Supporting documentation for the intended performer of the action
    "condition" : [{ // Whether or not the action is applicable
      "kind" : "<code>", // R!  applicability | start | stop
      "expression" : { Expression } // Boolean-valued expression
    }],
    "relatedAction" : [{ // Relationship to another action
      "actionId" : "<id>", // R!  What action this is related to
      "relationship" : "<code>", // R!  before-start | before | before-end | concurrent-with-start | concurrent | concurrent-with-end | after-start | after | after-end
      // offset[x]: Time offset for the relationship. One of these 2:
      "offsetDuration" : { Duration }
      "offsetRange" : { Range }
    }],
    // timing[x]: When the action should take place. One of these 6:
    "timingDateTime" : "<dateTime>",
    "timingAge" : { Age },
    "timingPeriod" : { Period },
    "timingDuration" : { Duration },
    "timingRange" : { Range },
    "timingTiming" : { Timing },
    "participant" : [{ Reference(Patient|Practitioner|PractitionerRole|
    RelatedPerson|Device) }], // Who should perform the action
    "type" : { CodeableConcept }, // create | update | remove | fire-event
    "groupingBehavior" : "<code>", // visual-group | logical-group | sentence-group
    "selectionBehavior" : "<code>", // any | all | all-or-none | exactly-one | at-most-one | one-or-more
    "requiredBehavior" : "<code>", // must | could | must-unless-documented
    "precheckBehavior" : "<code>", // yes | no
    "cardinalityBehavior" : "<code>", // single | multiple
    "resource" : { Reference(Any) }, // C? The target of the action
    "action" : [{ Content as for RequestGroup.action }] // C? Sub action
  }]
}

RequestGroup Search Parameters

The following search parameters can be used to query RequestGroup resources. Just submit them like so:

https://api.1up.health/fhir/r4/RequestGroup?query-param=queryvalue
Search ParameterField TypeResource Fields Searched
authorreferenceauthor
authoreddateauthoredOn
codetextcode
encounterreferenceencounter
group-identifiertextgroupIdentifier
identifiertextidentifier
instantiates-canonicalreferenceinstantiatesCanonical
instantiates-uriuriinstantiatesUri
intenttextintent
participantreferenceaction.participant
patientreferencesubject.where
prioritytextpriority
statustextstatus
subjectreferencesubject