app.bsky.notification.getGroupedNotifications

#main

[UNSTABLE - DO NOT USE THIS ENDPOINT WHILE THIS NOTE IS HERE] Enumerate notifications for the requesting account, pre-grouped for rendering. Supersedes listNotifications. Requires auth.

Parameters

Property	Type	Known Values	Required	Description
feed	string	all people-i-follow conversations followers activity	❌	Which notification feed to return. Grouping behavior varies by feed: notifications about follows might be grouped in 'all' and ungrouped (or rather, in single-item groups) in 'followers'.
limit	integer	-	❌	Maximum number of groups to return.
cursor	string	-	❌	-

Output

Encoding: application/json

Property	Type	Known Values	Required	Description
cursor	string	-	❌	-
groups	array of #group	-	✅	Notification groups or individual notifications, newest first. Clients should ignore kinds they do not recognize. Grouping behavior depends on the kind and selected feed.
seenAt	string (datetime)	-	❌	-
relatedViews	array of union app.bsky.actor.defs#profileViewDetailed app.bsky.feed.defs#blockedPost app.bsky.feed.defs#generatorView app.bsky.feed.defs#notFoundPost app.bsky.feed.defs#postView app.bsky.graph.defs#starterPackView	-	❌	Reusable views referenced by notifications. Views shared across notifications appear once to avoid duplication. Each group contributes only its first 10 of each related view to this array. Ex: for a group containing likes in a post, we might have a large number of likeItem (e.g., 50) in a group, but only the profile views for the newest 10 items will be included here.

#group

Contains common metadata and kind-specific data for a notification group or individual notification.

Property	Type	Known Values	Required	Description
id	string	-	✅	-
isRead	boolean	-	✅	-
indexedAt	string (datetime)	-	✅	-
count	integer	-	✅	-
kind	union of #likeGroup #multiPostLikeGroup #repostGroup #likeViaRepostGroup #repostViaRepostGroup #followGroup #subscribedPostGroup #generatorLikeGroup #replyNotification #quoteNotification #mentionNotification #followBackNotification #verifiedNotification #unverifiedNotification #starterPackJoinedNotification #contactMatchNotification	-	✅	-

#likeGroup

Group of likes by different actors on the same post.

Property	Type	Known Values	Required	Description
post	string (at-uri)	-	✅	-
items	array of #likeItem	-	✅	-

#likeItem

One actor who liked the group's post.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-

#multiPostLikeGroup

Group of likes by the same actor on different posts.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-
items	array of #multiPostLikeItem	-	✅	-

#multiPostLikeItem

One post which was liked by the group's actor.

Property	Type	Known Values	Required	Description
post	string (at-uri)	-	✅	-

#repostGroup

Group of reposts by different actors of the same post.

Property	Type	Known Values	Required	Description
post	string (at-uri)	-	✅	-
items	array of #repostItem	-	✅	-

#repostItem

One actor who reposted the group's post.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-

#likeViaRepostGroup

Group of likes by different actors on the same post via the requesting account's repost.

Property	Type	Known Values	Required	Description
post	string (at-uri)	-	✅	-
viaRepost	string (at-uri)	-	✅	-
items	array of #likeViaRepostItem	-	✅	-

#likeViaRepostItem

One actor who liked the group's post via the requesting account's repost.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-

#repostViaRepostGroup

Group of reposts by different actors of the same post via the requesting account's repost.

Property	Type	Known Values	Required	Description
post	string (at-uri)	-	✅	-
viaRepost	string (at-uri)	-	✅	-
items	array of #repostViaRepostItem	-	✅	-

#repostViaRepostItem

One actor who reposted the group's post via the requesting account's repost.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-

#followGroup

Group of actors who followed the requesting account.

Property	Type	Known Values	Required	Description
items	array of #followItem	-	✅	-

#followItem

An actor who followed the requesting account, possibly via a starter pack.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-
starterPack	string (at-uri)	-	❌	-

#subscribedPostGroup

Group of new posts by actors the requesting account subscribes to.

Property	Type	Known Values	Required	Description
items	array of #subscribedPostItem	-	✅	-

#subscribedPostItem

One new post by an actor the requesting account subscribes to.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-
post	string (at-uri)	-	✅	-

#generatorLikeGroup

Group of likes by different actors on the same feed generator.

Property	Type	Known Values	Required	Description
generator	string (at-uri)	-	✅	-
items	array of #generatorLikeItem	-	✅	-

#generatorLikeItem

One actor who liked the feed generator in the group.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-

#replyNotification

A reply to a post by the requesting account or to a thread they are participating in.

Property	Type	Known Values	Required	Description
post	string (at-uri)	-	✅	-
parent	string (at-uri)	-	✅	-

#quoteNotification

A post quoting a post by the requesting account.

Property	Type	Known Values	Required	Description
post	string (at-uri)	-	✅	-
parent	string (at-uri)	-	❌	-

#mentionNotification

A post mentioning the requesting account.

Property	Type	Known Values	Required	Description
post	string (at-uri)	-	✅	-
parent	string (at-uri)	-	❌	-

#followBackNotification

An actor followed the requesting account back, possibly via a starter pack.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-
starterPack	string (at-uri)	-	❌	-

#verifiedNotification

An actor verified the requesting account.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-

#unverifiedNotification

A verification of the requesting account was removed.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-

#starterPackJoinedNotification

An actor joined Bluesky via a starter pack created by the requesting account.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-
starterPack	string (at-uri)	-	✅	-

#contactMatchNotification

A contact of the requesting account joined Bluesky.

Property	Type	Known Values	Required	Description
actor	string (did)	-	✅	-

#main​

Parameters​

Output​

#group​

#likeGroup​

#likeItem​

#multiPostLikeGroup​

#multiPostLikeItem​

#repostGroup​

#repostItem​

#likeViaRepostGroup​

#likeViaRepostItem​

#repostViaRepostGroup​

#repostViaRepostItem​

#followGroup​

#followItem​

#subscribedPostGroup​

#subscribedPostItem​

#generatorLikeGroup​

#generatorLikeItem​

#replyNotification​

#quoteNotification​

#mentionNotification​

#followBackNotification​

#verifiedNotification​

#unverifiedNotification​

#starterPackJoinedNotification​

#contactMatchNotification​