app.bsky.notification.listNotifications
#main
Enumerate notifications for the requesting account. Requires auth.
Parameters
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| reasons | array | - | ❌ | A reason that matches the reason property of #notification. |
| limit | integer | - | ❌ | - |
| priority | boolean | - | ❌ | Deprecated: this parameter is ignored. |
| cursor | string | - | ❌ | - |
| seenAt | string (datetime) | - | ❌ | Deprecated: this parameter is unsupported and will cause an error. |
Output
- Encoding: application/json
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| cursor | string | - | ❌ | - |
| notifications | array of #notification | - | ✅ | - |
| priority | boolean | - | ❌ | Deprecated: this field is no longer populated. |
| seenAt | string (datetime) | - | ❌ | - |
#notification
| Property | Type | Known Values | Required | Description |
|---|---|---|---|---|
| uri | string (at-uri) | - | ✅ | - |
| cid | string (cid) | - | ✅ | - |
| author | app.bsky.actor.defs#profileView | - | ✅ | - |
| reason | string | like repost follow mention reply quote starterpack-joined verified unverified like-via-repost repost-via-repost subscribed-post contact-match | ✅ | The reason why this notification was delivered - e.g. your post was liked, or you received a new follower. |
| reasonSubject | string (at-uri) | - | ❌ | - |
| record | unknown | - | ✅ | - |
| starterPack | app.bsky.graph.defs#starterPackViewBasic | - | ❌ | - |
| isRead | boolean | - | ✅ | - |
| indexedAt | string (datetime) | - | ✅ | - |
| labels | array of com.atproto.label.defs#label | - | ❌ | - |