Paginated notifications addressed to the requesting viewer, newest first. The viewer DID is read from the service-auth JWT (`iss` claim) — no `?viewer=` query parameter.
Parameters
cursor
string
Optional
Opaque pagination cursor returned by a previous call.
limit
integer
Optional
Maximum number of notifications to return.
reasons
array
of string
Optional
Reasons to include. Absent → post-liked, post-replied, reply-liked (the reasons that predate mentions, so clients unaware of newer reasons never receive a record they cannot decode). Unknown values are ignored; an empty set after filtering yields an empty page.
Output
application/jsoncursor
string
Optional
Cursor for fetching the next page. Absent when no further results are available.
notifications
array
Required
No description available.
seenAt
stringdatetime
Optional
The server's currently persisted seenAt for this viewer. Absent when never set.
Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
View raw schema
{
"description": "Paginated notifications addressed to the requesting viewer, newest first. The viewer DID is read from the service-auth JWT (`iss` claim) — no `?viewer=` query parameter.",
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"cursor": {
"description": "Cursor for fetching the next page. Absent when no further results are available.",
"maxLength": 1024,
"type": "string"
},
"notifications": {
"items": {
"ref": "app.tempomusic.notification.defs#notificationView",
"type": "ref"
},
"type": "array"
},
"seenAt": {
"description": "The server's currently persisted seenAt for this viewer. Absent when never set.",
"format": "datetime",
"type": "string"
}
},
"required": [
"notifications"
],
"type": "object"
}
},
"parameters": {
"properties": {
"cursor": {
"description": "Opaque pagination cursor returned by a previous call.",
"maxLength": 1024,
"type": "string"
},
"limit": {
"default": 50,
"description": "Maximum number of notifications to return.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"reasons": {
"description": "Reasons to include. Absent → post-liked, post-replied, reply-liked (the reasons that predate mentions, so clients unaware of newer reasons never receive a record they cannot decode). Unknown values are ignored; an empty set after filtering yields an empty page.",
"items": {
"maxLength": 100,
"type": "string"
},
"maxLength": 10,
"type": "array"
}
},
"type": "params"
},
"type": "query"
}