Returns one deterministic, bounded page of stored messages belonging
to the authenticated identity in the specified message box. Returns an
empty array if the box does not exist. Message bodies are always
returned as strings (JSON objects are stringified).
Body application/json
messageBoxstringrequired
Name of the message box to retrieve messages from.
limitinteger
offsetinteger
skipinteger
Compatibility alias for offset; both must match if supplied together.
Response
Messages retrieved successfully (array may be empty).
status"success"
messagesobject[]
Show messages properties
messageIdstring
bodystring
Stringified message body (JSON objects are JSON.stringify-ed before storage).
senderstring
Compressed secp256k1 public key encoded as a 66-character hex string.
createdAtstring<date-time>
updatedAtstring<date-time>
limitinteger
offsetinteger
nextOffsetinteger
Offset for the next page; unchanged when the result is empty.
hasMoreboolean
Invalid or missing message box name.
Codes: ERR_MESSAGEBOX_REQUIRED, ERR_INVALID_MESSAGEBOX
status"error"
codestring
Machine-readable error code (see specs/errors.md).
descriptionstring
Human-readable explanation.
Authentication required.
status"error"
codestring
Machine-readable error code (see specs/errors.md).
descriptionstring
Human-readable explanation.
Internal server error (ERR_INTERNAL_ERROR).
status"error"
codestring
Machine-readable error code (see specs/errors.md).