CommunicationRequest - FHIR Resource (stu3)
This CommunicationRequest Resource uses the
FHIR API standard for access and structure.
Validate an CommunicationRequest FHIR Resource (stu3)
CommunicationRequest Attributes
AttributeField is listTypeDescription
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: 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
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: Why is communication needed?
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"reasonReference":
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: 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: "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: 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: 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: Focal resources
Attribute Type : Reference
Required: N/A
Countability: Array
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Description: draft | active | suspended | cancelled | 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: 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: "occurrencePeriod" : { Period },
Attribute Type : Period
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"occurrencePeriod":
Description: Encounter or episode leading to message
Attribute Type : Reference
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"context": {
"reference": "Encounter/example"
}
Description: Who/what is requesting service
Attribute Type : Data Type
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: Message urgency
Attribute Type : code
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
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: "occurrenceDateTime" : "<dateTime>",
Attribute Type : dateTime
Required: N/A
Countability: Singleton
Flags: N/A
Terminology bindings: N/A
Requirements: N/A
Comments: N/A
Example:"occurrenceDateTime":
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: 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"
}
CommunicationRequest Example
{
"status": "active",
"resourceType": "CommunicationRequest",
"text": {
"status": "generated",
"div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">To be filled out at a later time</div>"
},
"context": {
"reference": "Encounter/example"
},
"id": "example",
"subject": {
"reference": "Patient/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 | suspended | cancelled | completed | entered-in-error | unknown
"category" : [{ CodeableConcept }], // Message category
"priority" : "<code>", // Message urgency
"medium" : [{ CodeableConcept }], // A channel of communication
"subject" : { Reference(Patient|Group) }, // Focus of message
"recipient" : [{ Reference(Device|Organization|Patient|Practitioner|
RelatedPerson|Group|CareTeam) }], // Message recipient
"topic" : [{ Reference(Any) }], // Focal resources
"context" : { Reference(Encounter|EpisodeOfCare) }, // Encounter or episode leading to message
"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
"sender" : { Reference(Device|Organization|Patient|Practitioner|
RelatedPerson) }, // Message sender
"requester" : { // Who/what is requesting service
"agent" : { Reference(Practitioner|Organization|Patient|RelatedPerson|
Device) }, // R! Individual making the request
"onBehalfOf" : { Reference(Organization) } // C? Organization agent is acting for
},
"reasonCode" : [{ CodeableConcept }], // Why is communication needed?
"reasonReference" : [{ Reference(Condition|Observation) }], // 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/stu3/CommunicationRequest?query-param=queryvalue
Search Parameter | Field Type | Resource Fields Searched |
---|
authored | date | authoredOn |
based-on | reference | basedOn |
category | text | category |
context | reference | context |
encounter | reference | context |
group-identifier | text | groupIdentifier |
identifier | text | identifier |
medium | text | medium |
occurrence | date | occurrence.as |
patient | reference | subject |
priority | text | priority |
recipient | reference | recipient |
replaces | reference | replaces |
requester | reference | requester.agent |
sender | reference | sender |
status | text | status |
subject | reference | subject |