CommunicationRequest - FHIR Resource (r4)
This CommunicationRequest Resource uses the
FHIR API standard for access and structure.
Validate an CommunicationRequest FHIR Resource (r4)
CommunicationRequest Attributes
AttributeField is listTypeDescription
Description: Unique identifier
Attribute Type : Identifier
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Fulfills plan or proposal
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Request(s) replaced by this request
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Composite request this is part of
Attribute Type : Identifier
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"groupIdentifier":
Description: draft | active | on-hold | revoked | completed | entered-in-error | unknown
Attribute Type : code
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"status": "active"
Description: Reason for current status
Attribute Type : CodeableConcept
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Message category
Attribute Type : CodeableConcept
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: routine | urgent | asap | stat
Attribute Type : code
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: True if request is prohibiting action
Attribute Type : boolean
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: A channel of communication
Attribute Type : CodeableConcept
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Focus of message
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"subject": {
"reference": "Patient/example"
}
Description: Resources that pertain to this communication request
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Encounter created as part of
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"encounter": {
"reference": "Encounter/example"
}
Description: Message payload
Attribute Type : Data Type
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description:
Attribute Type : dateTime|Period
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: When request transitioned to being actionable
Attribute Type : dateTime
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: "requester" : { Reference(Practitioner|PractitionerRole|Organization|
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: "recipient" : [{ Reference(Device|Organization|Patient|Practitioner|
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: "sender" : { Reference(Device|Organization|Patient|Practitioner|
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: Why is communication needed?
Attribute Type : CodeableConcept
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: "reasonReference" : [{ Reference(Condition|Observation|DiagnosticReport|
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"reasonReference":
Description: Comments made about communication request
Attribute Type : Annotation
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
CommunicationRequest Example
{
"resourceType": "CommunicationRequest",
"id": "example",
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">To be filled out at a later time</div>"
},
"status": "active",
"subject": {
"reference": "Patient/example"
},
"encounter": {
"reference": "Encounter/example"
}
}
CommunicationRequest Structure
{
"resourceType" : "CommunicationRequest",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Unique identifier
"basedOn" : [{ Reference(Any) }], // Fulfills plan or proposal
"replaces" : [{ Reference(CommunicationRequest) }], // 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
"statusReason" : { CodeableConcept }, // Reason for current status
"category" : [{ CodeableConcept }], // Message category
"priority" : "<code>", // routine | urgent | asap | stat
"doNotPerform" : <boolean>, // True if request is prohibiting action
"medium" : [{ CodeableConcept }], // A channel of communication
"subject" : { Reference(Patient|Group) }, // Focus of message
"about" : [{ Reference(Any) }], // Resources that pertain to this communication request
"encounter" : { Reference(Encounter) }, // Encounter created as part of
"payload" : [{ // Message payload
// content[x]: Message part content. One of these 3:
"contentString" : "<string>"
"contentAttachment" : { Attachment }
"contentReference" : { Reference(Any) }
}],
// occurrence[x]: When scheduled. One of these 2:
"occurrenceDateTime" : "<dateTime>",
"occurrencePeriod" : { Period },
"authoredOn" : "<dateTime>", // When request transitioned to being actionable
"requester" : { Reference(Practitioner|PractitionerRole|Organization|
Patient|RelatedPerson|Device) }, // Who/what is requesting service
"recipient" : [{ Reference(Device|Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson|Group|CareTeam|HealthcareService) }], // Message recipient
"sender" : { Reference(Device|Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson|HealthcareService) }, // Message sender
"reasonCode" : [{ CodeableConcept }], // Why is communication needed?
"reasonReference" : [{ Reference(Condition|Observation|DiagnosticReport|
DocumentReference) }], // Why is communication needed?
"note" : [{ Annotation }] // Comments made about communication request
}
CommunicationRequest Search Parameters
The following search parameters can be used to query CommunicationRequest resources. Just submit them like so:
https://api.1up.health/fhir/r4/CommunicationRequest?query-param=queryvalue
Search Parameter | Field Type | Resource Fields Searched |
---|
authored | date | authoredOn |
based-on | reference | basedOn |
category | text | category |
encounter | reference | encounter |
group-identifier | text | groupIdentifier |
identifier | text | identifier |
medium | text | medium |
occurrence | date | occurrence |
patient | reference | subject.where |
priority | text | priority |
recipient | reference | recipient |
replaces | reference | replaces |
requester | reference | requester |
sender | reference | sender |
status | text | status |
subject | reference | subject |