Get detailed information about a message
get
/20241001/patientMessages/{patientMessageId}
This resource retrieves the details about a message based on a given message ID. Only a single message ID can be provided at a time.
Returns a 400 status code if multiple message IDs are provided.
Request
Path Parameters
-
patientMessageId(required): string
The unique identifier of the message.
Query Parameters
-
shouldLoadOrganizationSummary: boolean
If true, the inbox item list and message details by ID populate the organization object, which includes ID, display, and orgTypes.Default Value:
false
Header Parameters
-
accept: string
Specifies which media types are acceptable for the response. Defaults to
application/json.Default Value:application/json -
accept-charset: string
Specifies which character sets are acceptable for the response. Defaults to
UTF-8.Default Value:UTF-8 -
authorization(required): string
Contains the credentials to authenticate a consumer to the service.
-
opc-request-id: string
Unique Oracle Health assigned identifier for the request. If you need to contact Oracle about a particular request, provide the request ID. The only valid characters for request IDs are letters, numbers, underscore, and dash.
Response
Supported Media Types
- application/json
200 Response
Contains details about the retrieved message.
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : PatientMessage
Type:
objectThe detailed information about a message.
Show Source
-
attachments:
array attachments
The list of attachments on the message.
-
canReply:
boolean
An indicator that the message can be replied to.
-
carbonCopyRecipients:
array carbonCopyRecipients
The list of carbon copy receivers.
-
content(required):
string
The content of the message in XHTML format. The service supports HTML5, but a subset of the tags are disallowed. The user is informed through a detailed 400 error if the content contains an invalid tag.
-
conversationId:
string
The identifier of the conversation that the message is part of.
-
createDateTime(required):
createDateTime
The date and time that the message was created.
-
dueDateTime:
dueDateTime
The date and time that the message becomes due.
-
encounter:
encounter
The information about the encounter associated with the message.
-
id(required):
string
The identifier of the message.
-
messageSender(required):
messageSender
The details about the sender.
-
notificationType(required):
notificationType
The type of the message.
-
notificationVersion(required):
integer
The sender's version of the message.
-
patient:
patient
The patient who is the subject of the message or who the message is about.
-
priority(required):
priority
The priority of the message.
-
recipientAccessed:
array recipientAccessed
The list of receivers that have at least read the message. Their message is not in UNREAD status.
-
recipientNotificationVersion:
integer
The recipient's version of the message. Only populated if user is one of the recipients.
-
recipients(required):
array recipients
The list of receivers.
- relatedMessageIds: array relatedMessageIds
-
remindDateTime:
remindDateTime
The date and time that the reminder should appear.
-
responsiblePersonnelId:
string
The identifier of the responsible personnel for the message. Used for reporting and helps systems and users handle the message.
-
status:
status
The status of the message. The status is not populated if retrieving the details of a sent notification.
-
subject:
string
The subject of the message.
-
updateDateTime(required):
updateDateTime
The date and time that the message was last updated.
Nested Schema : attachments
Type:
arrayThe list of attachments on the message.
Show Source
-
Array of:
object Attachment
The details about a message attachment.
Nested Schema : carbonCopyRecipients
Type:
arrayThe list of carbon copy receivers.
Show Source
-
Array of:
object Participant
The sender or recipient of the message.
Nested Schema : createDateTime
The date and time that the message was created.
Match All
The date and time that the message was created.
Show Source
-
object
DateTimeWithZone
A representation of the date and time with the time zone.
Nested Schema : dueDateTime
The date and time that the message becomes due.
Match All
The date and time that the message becomes due.
Show Source
-
object
DateTimeWithZone
A representation of the date and time with the time zone.
Nested Schema : encounter
The information about the encounter associated with the message.
Match All
The information about the encounter associated with the message.
Show Source
Nested Schema : messageSender
The details about the sender.
Match All
The details about the sender.
Show Source
-
object
SenderSummary
The sender of the message.
Nested Schema : notificationType
The type of the message.
Match All
The type of the message.
Show Source
-
object
NotificationType
The information about the message type.
Nested Schema : patient
The patient who is the subject of the message or who the message is about.
Match All
The patient who is the subject of the message or who the message is about.
Show Source
-
object
PersonSimple
A simple representation of the individual person that was retrieved. The individual could be a personnel member (provider), a patient, or a nonpatient person.
Nested Schema : priority
The priority of the message.
Match All
The priority of the message.
Show Source
Nested Schema : recipientAccessed
Type:
arrayThe list of receivers that have at least read the message. Their message is not in UNREAD status.
Show Source
-
Array of:
object Participant
The sender or recipient of the message.
Nested Schema : recipients
Type:
arrayThe list of receivers.
Show Source
-
Array of:
object Participant
The sender or recipient of the message.
Nested Schema : remindDateTime
The date and time that the reminder should appear.
Match All
The date and time that the reminder should appear.
Show Source
-
object
DateTimeWithZone
A representation of the date and time with the time zone.
Nested Schema : status
The status of the message. The status is not populated if retrieving the details of a sent notification.
Match All
The status of the message. The status is not populated if retrieving the details of a sent notification.
Show Source
-
object
NotificationStatus
The information about the status of a message.
Nested Schema : updateDateTime
The date and time that the message was last updated.
Match All
The date and time that the message was last updated.
Show Source
-
object
DateTimeWithZone
A representation of the date and time with the time zone.
Nested Schema : Attachment
Type:
objectThe details about a message attachment.
Show Source
-
id(required):
string
The identifier of the attachment.
-
name(required):
string
The name of the attachment
-
version(required):
integer
The version of the attachment.
Nested Schema : Participant
Type:
objectThe sender or recipient of the message.
Show Source
-
groupInboxName:
string
The name of the group inbox, for cases where the participant is of type group inbox.
-
id(required):
string
The unique identifier for the participant.
-
personName:
personName
The name of the person, for cases where the participant is of type person.
-
personnelName:
personnelName
The name of the personnel, for cases where the participant is of type personnel.
-
type(required):
string
Allowed Values:
[ "PERSON", "PERSONNEL", "GROUPINBOX" ]The type of the participant. This field must be set. Set toPERSONfor sent item sender. Set toPERSONNELorGROUPINBOXfor sent item recipients and inbox item carbon copy recipients. Set toPERSON,PERSONNEL, orGROUPINBOXfor inbox item recipients.
Nested Schema : personName
The name of the person, for cases where the participant is of type person.
Match All
The name of the person, for cases where the participant is of type person.
Show Source
-
object
PersonNameSummary
A summary of just first, last, and full name for a person (which could be a personnel member, patient, or nonpatient person).
Nested Schema : personnelName
The name of the personnel, for cases where the participant is of type personnel.
Match All
The name of the personnel, for cases where the participant is of type personnel.
Show Source
-
object
PersonNameSummary
A summary of just first, last, and full name for a person (which could be a personnel member, patient, or nonpatient person).
Nested Schema : PersonNameSummary
Type:
objectA summary of just first, last, and full name for a person (which could be a personnel member, patient, or nonpatient person).
Show Source
-
firstName:
string
The person's first given name.
-
fullName:
string
The fully formatted name.
-
lastName:
string
The person's family last name.
Nested Schema : DateTimeWithZone
Type:
objectA representation of the date and time with the time zone.
Show Source
-
dateTime:
string(date-time)
The date and time represented in YYYY-MM-DDTHH:MM:SS:SSSZ format without the UTC offset as defined by RFC 3339. No timezone information is associated with this date/time.
-
ianaTimeZone:
string
The time zone, provided that the date includes time precision. If
dateTimecontains time, then this field is required.
Nested Schema : Encounter
Type:
objectThe encounter associated with the message.
Show Source
-
id(required):
string
The unique identifier for the encounter.
-
organization:
organization
The organization associated with the encounter.
Nested Schema : organization
The organization associated with the encounter.
Match All
The organization associated with the encounter.
Show Source
-
object
Organization
The organization associated with the patient and encounter. Only loaded for inbox list and message details views when the
OptionalShouldLoadOrganizationSummaryis set.
Nested Schema : Organization
Type:
objectThe organization associated with the patient and encounter.
Only loaded for inbox list and message details views when the
Show Source
OptionalShouldLoadOrganizationSummary is set.
-
display:
string
The display name for the organization.
-
id(required):
string
The unique identifier for the organization.
-
orgTypes:
array orgTypes
The list of the organization types.
Nested Schema : SenderSummary
Type:
objectThe sender of the message.
Show Source
-
groupInboxSummary:
groupInboxSummary
The details of the group inbox, for cases where the participant is of type group inbox.
-
id(required):
string
The unique identifier for the participant.
-
personName:
personName
The name of the person, for cases where the participant is of type person.
-
personnelName:
personnelName
The name of the personnel, for cases where the participant is of type personnel.
-
type(required):
string
Allowed Values:
[ "PERSON", "PERSONNEL", "GROUPINBOX" ]The type of the participant. This field must be set. Set toPERSONfor sent item sender. Set toPERSONNELorGROUPINBOXfor sent item recipients. Set toPERSONNELorGROUPINBOXfor inbox item sender.
Nested Schema : groupInboxSummary
The details of the group inbox, for cases where the participant is of type group inbox.
Match All
The details of the group inbox, for cases where the participant is of type group inbox.
Show Source
-
object
GroupInboxSummary
The summary of the Group Inbox sender.
Nested Schema : personName
The name of the person, for cases where the participant is of type person.
Match All
The name of the person, for cases where the participant is of type person.
Show Source
-
object
PersonNameSummary
A summary of just first, last, and full name for a person (which could be a personnel member, patient, or nonpatient person).
Nested Schema : personnelName
The name of the personnel, for cases where the participant is of type personnel.
Match All
The name of the personnel, for cases where the participant is of type personnel.
Show Source
-
object
PersonNameSummary
A summary of just first, last, and full name for a person (which could be a personnel member, patient, or nonpatient person).
Nested Schema : GroupInboxSummary
Type:
objectThe summary of the Group Inbox sender.
Show Source
-
groupInboxName(required):
string
The name of the group inbox.
-
personnelSender:
personnelSender
The sender who sent the message from group inbox.
Nested Schema : personnelSender
The sender who sent the message from group inbox.
Match All
The sender who sent the message from group inbox.
Show Source
-
object
PersonSimple
A simple representation of the individual person that was retrieved. The individual could be a personnel member (provider), a patient, or a nonpatient person.
Nested Schema : PersonSimple
Type:
objectA simple representation of the individual person that was retrieved.
The individual could be a personnel member (provider), a patient, or a nonpatient person.
Show Source
-
id(required):
string
The unique identifier for the individual.
-
name:
object PersonNameSummary
A summary of just first, last, and full name for a person (which could be a personnel member, patient, or nonpatient person).
Nested Schema : NotificationType
Type:
objectThe information about the message type.
Show Source
-
value(required):
string
Allowed Values:
[ "MESSAGE", "REMINDER", "UNKNOWN" ]The type of message.
Nested Schema : Priority
Type:
objectThe priority of the message.
Show Source
-
value(required):
string
Allowed Values:
[ "HIGH", "NORMAL" ]The value of the priority.HIGHdenotesSTAT.NORMALdenotesROUTINE.
Nested Schema : NotificationStatus
Type:
objectThe information about the status of a message.
Show Source
-
value(required):
string
Allowed Values:
[ "UNREAD", "OPENED", "DELETED", "UNKNOWN" ]The status of the message.
400 Response
Bad Request
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : ApiError
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any and all errors from the resulting service request.
-
message(required):
string
A human-readable error message.
Nested Schema : details
Type:
arrayA list of details regarding any and all errors from the resulting service request.
Show Source
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
Nested Schema : ErrorDetail
Type:
objectAdditional detail information pertaining to the error.
Show Source
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
Nested Schema : ErrorDetailSource
Type:
objectAn object containing references to the source of the error.
Show Source
-
headers:
array headers
A list of the request headers that caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error. For example,
/datafor a primary data object, or/data/attributes/titlefor a specific attribute. A JSON Pointer must point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.
Nested Schema : headers
Type:
arrayA list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type:
arrayA list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type:
arrayA list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
Show Source
/data for a primary data object, or /data/attributes/title for a specific attribute. A JSON Pointer must
point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.
401 Response
Unauthorized
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : ApiError
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any and all errors from the resulting service request.
-
message(required):
string
A human-readable error message.
Nested Schema : details
Type:
arrayA list of details regarding any and all errors from the resulting service request.
Show Source
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
Nested Schema : ErrorDetail
Type:
objectAdditional detail information pertaining to the error.
Show Source
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
Nested Schema : ErrorDetailSource
Type:
objectAn object containing references to the source of the error.
Show Source
-
headers:
array headers
A list of the request headers that caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error. For example,
/datafor a primary data object, or/data/attributes/titlefor a specific attribute. A JSON Pointer must point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.
Nested Schema : headers
Type:
arrayA list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type:
arrayA list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type:
arrayA list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
Show Source
/data for a primary data object, or /data/attributes/title for a specific attribute. A JSON Pointer must
point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.
404 Response
Not Found
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : ApiError
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any and all errors from the resulting service request.
-
message(required):
string
A human-readable error message.
Nested Schema : details
Type:
arrayA list of details regarding any and all errors from the resulting service request.
Show Source
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
Nested Schema : ErrorDetail
Type:
objectAdditional detail information pertaining to the error.
Show Source
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
Nested Schema : ErrorDetailSource
Type:
objectAn object containing references to the source of the error.
Show Source
-
headers:
array headers
A list of the request headers that caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error. For example,
/datafor a primary data object, or/data/attributes/titlefor a specific attribute. A JSON Pointer must point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.
Nested Schema : headers
Type:
arrayA list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type:
arrayA list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type:
arrayA list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
Show Source
/data for a primary data object, or /data/attributes/title for a specific attribute. A JSON Pointer must
point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.
429 Response
Too Many Requests
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : ApiError
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any and all errors from the resulting service request.
-
message(required):
string
A human-readable error message.
Nested Schema : details
Type:
arrayA list of details regarding any and all errors from the resulting service request.
Show Source
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
Nested Schema : ErrorDetail
Type:
objectAdditional detail information pertaining to the error.
Show Source
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
Nested Schema : ErrorDetailSource
Type:
objectAn object containing references to the source of the error.
Show Source
-
headers:
array headers
A list of the request headers that caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error. For example,
/datafor a primary data object, or/data/attributes/titlefor a specific attribute. A JSON Pointer must point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.
Nested Schema : headers
Type:
arrayA list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type:
arrayA list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type:
arrayA list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
Show Source
/data for a primary data object, or /data/attributes/title for a specific attribute. A JSON Pointer must
point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.
500 Response
Internal Server Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : ApiError
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any and all errors from the resulting service request.
-
message(required):
string
A human-readable error message.
Nested Schema : details
Type:
arrayA list of details regarding any and all errors from the resulting service request.
Show Source
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
Nested Schema : ErrorDetail
Type:
objectAdditional detail information pertaining to the error.
Show Source
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
Nested Schema : ErrorDetailSource
Type:
objectAn object containing references to the source of the error.
Show Source
-
headers:
array headers
A list of the request headers that caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error. For example,
/datafor a primary data object, or/data/attributes/titlefor a specific attribute. A JSON Pointer must point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.
Nested Schema : headers
Type:
arrayA list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type:
arrayA list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type:
arrayA list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
Show Source
/data for a primary data object, or /data/attributes/title for a specific attribute. A JSON Pointer must
point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.
Default Response
Unknown Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : ApiError
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
details:
array details
A list of details regarding any and all errors from the resulting service request.
-
message(required):
string
A human-readable error message.
Nested Schema : details
Type:
arrayA list of details regarding any and all errors from the resulting service request.
Show Source
-
Array of:
object ErrorDetail
Additional detail information pertaining to the error.
Nested Schema : ErrorDetail
Type:
objectAdditional detail information pertaining to the error.
Show Source
-
detail:
string
A human-readable explanation specific to this occurrence of the problem.
-
source:
object ErrorDetailSource
An object containing references to the source of the error.
Nested Schema : ErrorDetailSource
Type:
objectAn object containing references to the source of the error.
Show Source
-
headers:
array headers
A list of the request headers that caused the error.
-
parameters:
array parameters
A list of which URI query parameters caused the error.
-
pointers:
array pointers
A list of JSON Pointers (RFC6901) to the values in the request document that caused the error. For example,
/datafor a primary data object, or/data/attributes/titlefor a specific attribute. A JSON Pointer must point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.
Nested Schema : headers
Type:
arrayA list of the request headers that caused the error.
Show Source
Nested Schema : parameters
Type:
arrayA list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type:
arrayA list of JSON Pointers (RFC6901) to the values in the request document that caused the error.
For example,
Show Source
/data for a primary data object, or /data/attributes/title for a specific attribute. A JSON Pointer must
point to a value in the request document that exists. If it does not exist, the client should ignore the pointer.