app.bsky.notification.listNotifications

Enumerate notifications for the requesting account. Requires auth.

Details · query
Kindquery
Authoritynotification.bsky.app
Indexed

Query

query · GET

Parameters

query string

cursor

string

limit

integer
  • minimum: 1
  • maximum: 100
  • default: 50

priority

boolean

Deprecated: this parameter is ignored.

reasons

array

Notification reasons to include in response.

itemsstring

A reason that matches the reason property of #notification.

seenAt

string · datetime

Deprecated: this parameter is unsupported and will cause an error.

Output

application/json

cursor

string

notifications

requiredarray
itemsref
Reference

priority

boolean

Deprecated: this field is no longer populated.

seenAt

string · datetime

#notification

object

Properties

cid

requiredstring · cid

indexedAt

requiredstring · datetime

isRead

requiredboolean

labels

array
itemsref

reason

requiredstring

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

reasonSubject

string · at-uri

record

requiredunknown

The starter pack associated with this notification. Present when the notification is for a follow originating from a starter pack.

uri

requiredstring · at-uri

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.