/api/qmail/db/notifications/list

GET

Return recent received-tell notifications (incoming-mail signals from the beacon), with the sender's display name resolved.

http://localhost:8081/api/qmail/db/notifications/list?limit=50

Description

Notifications are the recipient-side counterpart to pending tells. They appear when the beacon delivers an incoming-mail signal addressed to this account, and persist until the user dismisses them or the corresponding email is downloaded.

Parameters

ParamTypeRequiredDescription
limitintNoDefault 50, clamped 1..200.

Response

{
  "command": "notifications-list",
  "success": true,
  "count": 1,
  "notifications": [
    {
      "file_guid": "0c4f8e2a91b34d57a76e1d2c3b4a5968",
      "sender_sn": 9001,
      "sender_name": "Alex Chen",
      "tell_type": "new_email",
      "total_file_size": 14872,
      "timestamp": 1714083600,
      "downloaded": false
    }
  ]
}
FieldTypeDescription
tell_typestringnew_email, read_receipt, or deleted.
downloadedboolTrue once the recipient has downloaded the underlying email.
sender_namestring"First Last" if the sender is in contacts; otherwise SN#<serial>.

Errors

HTTPMessage
500Failed to query notifications

Example

curl "http://localhost:8081/api/qmail/db/notifications/list?limit=20"

Related