Mark Notifications Seen

POST /api/v1/account/notifications/seen

This endpoint marks the notifications that you send as seen. After that, Get notification history returns "read": true for them and leaves them out of unread_count.

Seen state belongs to the account. All the account’s devices and browsers see the same state.
There is no “mark all” call. Send the IDs that you show, for example when the user opens the list or taps a notification.
Pacifica ignores unknown IDs, IDs of other accounts, and IDs that aren’t in the in-app history.
The call is idempotent. Marking a seen notification again has no effect.

Operation Type (for Signing)

Header Field	Type	Content
`"type"`	string	`"mark_notifications_seen"`

Request Body

Field	Type	Need	Description	Example
`”account”`	string	required	User’s wallet address	`42trU9A5…`
`“signature”`	string	required	Cryptographic signature	`5j1Vy9Uq…`
`“timestamp”`	integer	required	Current timestamp in milliseconds	`1716200000000`
`”ids”`	array	required	Notification IDs from Get notification history or from a Web Push payload’s `notification_id`	`[81234, 81102]`
`“expiry_window”`	integer	optional	Signature expiry in milliseconds	`30000`
`”agent_wallet”`	string	optional	Agent wallet address	`69trU9A5…`

{
  "account": "42trU9A5...",
  "signature": "5j1Vy9Uq...",
  "timestamp": 1716200000000,
  "ids": [81234, 81102],
  "expiry_window": 30000
}

You can sign this request with the account key or with an agent wallet.

Response

Status 200: Notifications marked seen

{
  "success": true,
  "data": null,
  "error": null,
  "code": null
}

Status 400: Invalid request parameters or signature
Status 403: The account doesn’t exist. An account exists after its first deposit
Status 429: Rate limit exceeded
Status 500: Internal server error

Code Example (Python)

import requests

payload = {
    "account": "42trU9A5...",
    "signature": "5j1Vy9Uq...",
    "timestamp": 1716200000000,
    "ids": [81234, 81102]
}

response = requests.post(
    "/api/v1/account/notifications/seen",
    json=payload,
    headers={"Content-Type": "application/json"}
)

data = response.json()

​Operation Type (for Signing)

​Request Body

​Response

​Code Example (Python)

Operation Type (for Signing)

Request Body

Response

Code Example (Python)