Validate recipients

post

/20241001/actions/validateRecipients

Verifies that the given personnel and group inboxes are valid recipients and are able to receive the provided category of messages in their inbox.

Request

Header Parameters
  • Specifies which media types are acceptable for the response. Defaults to application/json.
    Default Value: application/json
  • Specifies which character sets are acceptable for the response. Defaults to UTF-8.
    Default Value: UTF-8
  • Contains the credentials to authenticate a consumer to the service.
  • Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID. The only valid characters for request IDs are letters, numbers, underscore, and dash.
Body ()
Details about the recipients to be validated.
Root Schema : ValidateRecipientsDetails
Type: object
Request object containing the list of recipients to validate and additional validation criteria.
Show Source
  • Allowed Values: [ "MESSAGES", "REMINDERS" ]
    Type of message. Validates that the recipients are configured to recieve this message category.
  • Identifier of a patient. This ID is used to validate that a message recipient is in the same logical domain as the patient associated with the message.
    Example: 2222
  • recipients
    List of recipients to be validated. This list can contain either personnel, group inboxes, or both.
Nested Schema : recipients
Type: array
List of recipients to be validated. This list can contain either personnel, group inboxes, or both.
Show Source
Nested Schema : Recipient
Type: object
Recipient details.
Show Source
Back to Top

Response

Supported Media Types

200 Response

Success
Headers
  • Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
Body ()
Root Schema : ValidatedRecipientCollection
Type: object
Results of validating the recipients.
Show Source
Nested Schema : items
Type: array
List of validated recipient details. The list may be empty and the order is not guaranteed.
Show Source
Nested Schema : ValidatedRecipientSummary
Type: object
Information about a validated recipient.
Show Source

400 Response

Bad Request
Headers
  • Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any errors from the resulting service call.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers which caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • pointers

    A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

    For example, /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, ignore the pointer.

Nested Schema : headers
Type: array
A list of the request headers which caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: array

A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

For example, /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, ignore the pointer.

Show Source

401 Response

Unauthorized
Headers
  • Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any errors from the resulting service call.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers which caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • pointers

    A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

    For example, /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, ignore the pointer.

Nested Schema : headers
Type: array
A list of the request headers which caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: array

A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

For example, /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, ignore the pointer.

Show Source

404 Response

Not Found
Headers
  • Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any errors from the resulting service call.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers which caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • pointers

    A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

    For example, /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, ignore the pointer.

Nested Schema : headers
Type: array
A list of the request headers which caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: array

A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

For example, /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, ignore the pointer.

Show Source

422 Response

Unprocessable Entity
Headers
  • Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any errors from the resulting service call.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers which caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • pointers

    A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

    For example, /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, ignore the pointer.

Nested Schema : headers
Type: array
A list of the request headers which caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: array

A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

For example, /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, ignore the pointer.

Show Source

429 Response

Too Many Requests
Headers
  • Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any errors from the resulting service call.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers which caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • pointers

    A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

    For example, /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, ignore the pointer.

Nested Schema : headers
Type: array
A list of the request headers which caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: array

A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

For example, /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, ignore the pointer.

Show Source

500 Response

Internal Server Error
Headers
  • Unique Oracle Cerner-assigned identifier for the request. If you need to contact Oracle Cerner about a particular request, you must provide the request ID.
Body ()
Root Schema : ApiError
Type: object
Error information.
Show Source
Nested Schema : details
Type: array
A list of details regarding any errors from the resulting service call.
Show Source
Nested Schema : ErrorDetail
Type: object
Additional detail information pertaining to the error.
Show Source
Nested Schema : ErrorDetailSource
Type: object
An object containing references to the source of the error.
Show Source
  • headers
    A list of the request headers which caused the error.
  • parameters
    A list of which URI query parameters caused the error.
  • pointers

    A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

    For example, /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, ignore the pointer.

Nested Schema : headers
Type: array
A list of the request headers which caused the error.
Show Source
Nested Schema : parameters
Type: array
A list of which URI query parameters caused the error.
Show Source
Nested Schema : pointers
Type: array

A list of JSON Pointers (RFC6901) to the values in the request document that caused the error.

For example, /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, ignore the pointer.

Show Source
Back to Top