so.sprk.notification.listNotifications
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"main": {
"description": "Enumerate notifications for the requesting account. Requires auth.",
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"cursor": {
"type": "string"
},
"notifications": {
"items": {
"ref": "#notification",
"type": "ref"
},
"type": "array"
},
"priority": {
"type": "boolean"
},
"seenAt": {
"format": "datetime",
"type": "string"
}
},
"required": [
"notifications"
],
"type": "object"
}
},
"parameters": {
"properties": {
"cursor": {
"type": "string"
},
"limit": {
"default": 50,
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"priority": {
"type": "boolean"
},
"reasons": {
"description": "Notification reasons to include in response.",
"items": {
"description": "A reason that matches the reason property of #notification.",
"type": "string"
},
"type": "array"
},
"seenAt": {
"format": "datetime",
"type": "string"
}
},
"type": "params"
},
"type": "query"
},
"notification": {
"properties": {
"author": {
"ref": "so.sprk.actor.defs#profileView",
"type": "ref"
},
"cid": {
"format": "cid",
"type": "string"
},
"indexedAt": {
"format": "datetime",
"type": "string"
},
"isRead": {
"type": "boolean"
},
"labels": {
"items": {
"ref": "com.atproto.label.defs#label",
"type": "ref"
},
"type": "array"
},
"reason": {
"description": "Expected values are 'like', 'repost', 'follow', 'mention', 'reply', 'quote', and 'starterpack-joined'.",
"knownValues": [
"like",
"repost",
"follow",
"mention",
"reply",
"like-via-repost",
"repost-via-repost"
],
"type": "string"
},
"reasonSubject": {
"format": "at-uri",
"type": "string"
},
"record": {
"type": "unknown"
},
"uri": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"uri",
"cid",
"author",
"reason",
"record",
"isRead",
"indexedAt"
],
"type": "object"
}
},
"id": "so.sprk.notification.listNotifications",
"lexicon": 1
}
Metadata
- DID
-
did:plc:cveom2iroj3mt747sd4qqnr2 - CID
-
bafyreicnucusisimz4zhvstxl4ion34vyu3gx6g2waqjrjkuj2o4n7hfoy - Indexed At
- 2026-04-21 22:28 UTC
- AT-URI
-
at://did:plc:cveom2iroj3mt747sd4qqnr2/com.atproto.lexicon.schema/so.sprk.notification.listNotifications
Referenced Schemas (2)
Similar Lexicons
Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
Enumerate notifications for the requesting account. Requires auth.
-
Enumerate notifications for the requesting account. Requires auth.
-
The viewer's Orbyt activity, newest first. Requires service auth.
-
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.
-
Notifications for the authenticated viewer (newest first). Includes read items; AppView may drop items older than 30 days.