Retrieve Message Fields Reference

Read about the messages fields that are returned when you retrieve a message.

The response body for the Retrieve a Message request is split into 3 sections:

  • MESSAGERAWRESPONSE: The raw response data.
  • STATUSRESPONSE: The status information.
  • MESSAGEDETAILSRESPONSE: The message details.

MESSAGERAWRESPONSE

FieldDetailsDescription
messageStringMessage content, specified in Base64 format.
messageInfoObjectThis contains the fields listed in the Message Details Fields Reference topic.

STATUSRESPONSE

FieldDetailsDescription
errorObjectThis object contains the fields listed in the Error Fields Reference topic.
lastChangedDate-TimeTimestamp of the message's last update, specified in ISO 8601 format.
messageIdUUIDID of the message.
receivedAtDate-TimeTimestamp of the message's receipt, specified in ISO 8601 format.
statusSting/EnumerationStatus of the message. The possible values are: HANDLED, TRANSMITTED, TRANSIENT ERROR, RETAINED, and PROCESSING. More details are provided in the Status Fields Reference topic.

MESSAGEDETAILSRESPONSE

FieldDetailsDescription
acknowledgmentStringConfirmation of the message, specified in Base64 format.
errorObjectThis object contains the fields listed in the Error Fields Reference topic.
externalReferencesObjectReferences to an external party such as a government.
historyArrayStatus history of the message.
history.messageStringMessage body at the time the historical record was created.
history.statusString/EnumerationStatus at the time the historical record was created. More details are provided in the Status Fields Reference topic.
history.timestampDate-TimeTimestamp of the historical record, specified in ISO 8601 format.
messageInfoObjectMetadata for a message. More details are provided in the Message Details Fields Reference topic.