app.bsky.notification.listNotifications
Enumerate notifications for the requesting account. Requires auth.
Details · query
| Kind | query |
|---|---|
| Authority | notification.bsky.app |
| Indexed |
Checks
Validunlimited-stringdefs.main.parameters.properties.cursorNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.parameters.properties.reasons.itemsNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.main.output.schema.properties.cursorNo maxLength, maxGraphemes or format limits this string.unlimited-stringdefs.notification.properties.reasonNo maxLength, maxGraphemes or format limits this string.
{
"$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": {
"description": "Deprecated: this field is no longer populated.",
"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": {
"description": "Deprecated: this parameter is ignored.",
"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": {
"description": "Deprecated: this parameter is unsupported and will cause an error.",
"format": "datetime",
"type": "string"
}
},
"type": "params"
},
"type": "query"
},
"notification": {
"properties": {
"author": {
"ref": "app.bsky.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": "The reason why this notification was delivered - e.g. your post was liked, or you received a new follower.",
"knownValues": [
"like",
"repost",
"follow",
"mention",
"reply",
"quote",
"starterpack-joined",
"verified",
"unverified",
"like-via-repost",
"repost-via-repost",
"subscribed-post",
"contact-match"
],
"type": "string"
},
"reasonSubject": {
"format": "at-uri",
"type": "string"
},
"record": {
"type": "unknown"
},
"starterPack": {
"description": "The starter pack associated with this notification. Present when the notification is for a follow originating from a starter pack.",
"ref": "app.bsky.graph.defs#starterPackViewBasic",
"type": "ref"
},
"uri": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"uri",
"cid",
"author",
"reason",
"record",
"isRead",
"indexedAt"
],
"type": "object"
}
},
"id": "app.bsky.notification.listNotifications",
"lexicon": 1
}