[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
No description available.
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'.
Maximum number of groups to return.
Output
Encodingapplication/json
No description available.
Notification groups or individual notifications, newest first. Clients should ignore kinds they do not recognize. Grouping behavior depends on the kind and selected feed.
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.
An RFC 3339 formatted timestamp.
Try It
Requests are sent directly from your browser. Some servers may block requests due to CORS.
Sending request...
View raw schema
{
"description": "[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.",
"output": {
"encoding": "application/json",
"schema": {
"properties": {
"cursor": {
"maxLength": 1024,
"type": "string"
},
"groups": {
"description": "Notification groups or individual notifications, newest first. Clients should ignore kinds they do not recognize. Grouping behavior depends on the kind and selected feed.",
"items": {
"ref": "#group",
"type": "ref"
},
"type": "array"
},
"relatedViews": {
"description": "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.",
"items": {
"refs": [
"app.bsky.actor.defs#profileViewBasic",
"app.bsky.feed.defs#blockedPost",
"app.bsky.feed.defs#generatorView",
"app.bsky.feed.defs#notFoundPost",
"app.bsky.feed.defs#postView",
"app.bsky.graph.defs#starterPackViewBasic"
],
"type": "union"
},
"type": "array"
},
"seenAt": {
"format": "datetime",
"type": "string"
}
},
"required": [
"groups"
],
"type": "object"
}
},
"parameters": {
"properties": {
"cursor": {
"maxLength": 1024,
"type": "string"
},
"feed": {
"default": "all",
"description": "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'.",
"knownValues": [
"all",
"people-i-follow",
"conversations",
"followers",
"activity"
],
"maxLength": 32,
"type": "string"
},
"limit": {
"default": 30,
"description": "Maximum number of groups to return.",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "params"
},
"type": "query"
}
An actor followed the requesting account back, possibly via a starter pack.
Properties
A decentralized identifier (DID).
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "An actor followed the requesting account back, possibly via a starter pack.",
"properties": {
"actor": {
"format": "did",
"type": "string"
},
"starterPack": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"actor"
],
"type": "object"
}
Group of actors who followed the requesting account.
Properties
No description available.
minLength: 1 items
View raw schema
{
"description": "Group of actors who followed the requesting account.",
"properties": {
"items": {
"items": {
"ref": "#followItem",
"type": "ref"
},
"minLength": 1,
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
}
An actor who followed the requesting account, possibly via a starter pack.
Properties
A decentralized identifier (DID).
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "An actor who followed the requesting account, possibly via a starter pack.",
"properties": {
"actor": {
"format": "did",
"type": "string"
},
"starterPack": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"actor"
],
"type": "object"
}
Group of likes by different actors on the same feed generator.
Properties
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
No description available.
minLength: 1 items
View raw schema
{
"description": "Group of likes by different actors on the same feed generator.",
"properties": {
"generator": {
"format": "at-uri",
"type": "string"
},
"items": {
"items": {
"ref": "#generatorLikeItem",
"type": "ref"
},
"minLength": 1,
"type": "array"
}
},
"required": [
"generator",
"items"
],
"type": "object"
}
One actor who liked the feed generator in the group.
Properties
A decentralized identifier (DID).
View raw schema
{
"description": "One actor who liked the feed generator in the group.",
"properties": {
"actor": {
"format": "did",
"type": "string"
}
},
"required": [
"actor"
],
"type": "object"
}
Contains common metadata and kind-specific data for a notification group or individual notification.
Properties
No description available.
minimum: 1
No description available.
maxLength: 256 bytes
An RFC 3339 formatted timestamp.
No description available.
No description available.
View raw schema
{
"description": "Contains common metadata and kind-specific data for a notification group or individual notification.",
"properties": {
"count": {
"minimum": 1,
"type": "integer"
},
"id": {
"maxLength": 256,
"type": "string"
},
"indexedAt": {
"format": "datetime",
"type": "string"
},
"isRead": {
"type": "boolean"
},
"kind": {
"refs": [
"#likeGroup",
"#multiPostLikeGroup",
"#multiPostRepostGroup",
"#multiPostLikeViaRepostGroup",
"#multiPostRepostViaRepostGroup",
"#repostGroup",
"#likeViaRepostGroup",
"#repostViaRepostGroup",
"#followGroup",
"#subscribedPostGroup",
"#generatorLikeGroup",
"#replyNotification",
"#quoteNotification",
"#mentionNotification",
"#followBackNotification",
"#verifiedNotification",
"#unverifiedNotification",
"#starterPackJoinedNotification",
"#contactMatchNotification"
],
"type": "union"
}
},
"required": [
"id",
"isRead",
"indexedAt",
"count",
"kind"
],
"type": "object"
}
Group of likes by different actors on the same post.
Properties
No description available.
minLength: 1 items
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "Group of likes by different actors on the same post.",
"properties": {
"items": {
"items": {
"ref": "#likeItem",
"type": "ref"
},
"minLength": 1,
"type": "array"
},
"post": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"post",
"items"
],
"type": "object"
}
One actor who liked the group's post.
Properties
A decentralized identifier (DID).
View raw schema
{
"description": "One actor who liked the group's post.",
"properties": {
"actor": {
"format": "did",
"type": "string"
}
},
"required": [
"actor"
],
"type": "object"
}
Group of likes by different actors on the same post via the requesting account's repost.
Properties
No description available.
minLength: 1 items
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "Group of likes by different actors on the same post via the requesting account's repost.",
"properties": {
"items": {
"items": {
"ref": "#likeViaRepostItem",
"type": "ref"
},
"minLength": 1,
"type": "array"
},
"post": {
"format": "at-uri",
"type": "string"
},
"viaRepost": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"post",
"viaRepost",
"items"
],
"type": "object"
}
One actor who liked the group's post via the requesting account's repost.
Properties
A decentralized identifier (DID).
View raw schema
{
"description": "One actor who liked the group's post via the requesting account's repost.",
"properties": {
"actor": {
"format": "did",
"type": "string"
}
},
"required": [
"actor"
],
"type": "object"
}
A post mentioning the requesting account.
Properties
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "A post mentioning the requesting account.",
"properties": {
"parent": {
"format": "at-uri",
"type": "string"
},
"post": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"post"
],
"type": "object"
}
Group of likes by the same actor on different posts.
Properties
A decentralized identifier (DID).
No description available.
minLength: 2 items
View raw schema
{
"description": "Group of likes by the same actor on different posts.",
"properties": {
"actor": {
"format": "did",
"type": "string"
},
"items": {
"items": {
"ref": "#multiPostLikeItem",
"type": "ref"
},
"minLength": 2,
"type": "array"
}
},
"required": [
"actor",
"items"
],
"type": "object"
}
One post which was liked by the group's actor.
Properties
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "One post which was liked by the group's actor.",
"properties": {
"post": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"post"
],
"type": "object"
}
Group of likes by the same actor on different posts via the requesting account's reposts.
Properties
A decentralized identifier (DID).
No description available.
minLength: 2 items
View raw schema
{
"description": "Group of likes by the same actor on different posts via the requesting account's reposts.",
"properties": {
"actor": {
"format": "did",
"type": "string"
},
"items": {
"items": {
"ref": "#multiPostLikeViaRepostItem",
"type": "ref"
},
"minLength": 2,
"type": "array"
}
},
"required": [
"actor",
"items"
],
"type": "object"
}
One post which was liked by the group's actor via the requesting account's repost.
Properties
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "One post which was liked by the group's actor via the requesting account's repost.",
"properties": {
"post": {
"format": "at-uri",
"type": "string"
},
"viaRepost": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"post",
"viaRepost"
],
"type": "object"
}
Group of reposts by the same actor of different posts.
Properties
A decentralized identifier (DID).
No description available.
minLength: 2 items
View raw schema
{
"description": "Group of reposts by the same actor of different posts.",
"properties": {
"actor": {
"format": "did",
"type": "string"
},
"items": {
"items": {
"ref": "#multiPostRepostItem",
"type": "ref"
},
"minLength": 2,
"type": "array"
}
},
"required": [
"actor",
"items"
],
"type": "object"
}
One post which was reposted by the group's actor.
Properties
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "One post which was reposted by the group's actor.",
"properties": {
"post": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"post"
],
"type": "object"
}
Group of reposts by the same actor of different posts via the requesting account's reposts.
Properties
A decentralized identifier (DID).
No description available.
minLength: 2 items
View raw schema
{
"description": "Group of reposts by the same actor of different posts via the requesting account's reposts.",
"properties": {
"actor": {
"format": "did",
"type": "string"
},
"items": {
"items": {
"ref": "#multiPostRepostViaRepostItem",
"type": "ref"
},
"minLength": 2,
"type": "array"
}
},
"required": [
"actor",
"items"
],
"type": "object"
}
One post which was reposted by the group's actor via the requesting account's repost.
Properties
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "One post which was reposted by the group's actor via the requesting account's repost.",
"properties": {
"post": {
"format": "at-uri",
"type": "string"
},
"viaRepost": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"post",
"viaRepost"
],
"type": "object"
}
A post quoting a post by the requesting account.
Properties
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "A post quoting a post by the requesting account.",
"properties": {
"parent": {
"format": "at-uri",
"type": "string"
},
"post": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"post"
],
"type": "object"
}
A reply to a post by the requesting account or to a thread they are participating in.
Properties
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "A reply to a post by the requesting account or to a thread they are participating in.",
"properties": {
"parent": {
"format": "at-uri",
"type": "string"
},
"post": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"post",
"parent"
],
"type": "object"
}
Group of reposts by different actors of the same post.
Properties
No description available.
minLength: 1 items
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "Group of reposts by different actors of the same post.",
"properties": {
"items": {
"items": {
"ref": "#repostItem",
"type": "ref"
},
"minLength": 1,
"type": "array"
},
"post": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"post",
"items"
],
"type": "object"
}
One actor who reposted the group's post.
Properties
A decentralized identifier (DID).
View raw schema
{
"description": "One actor who reposted the group's post.",
"properties": {
"actor": {
"format": "did",
"type": "string"
}
},
"required": [
"actor"
],
"type": "object"
}
Group of reposts by different actors of the same post via the requesting account's repost.
Properties
No description available.
minLength: 1 items
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "Group of reposts by different actors of the same post via the requesting account's repost.",
"properties": {
"items": {
"items": {
"ref": "#repostViaRepostItem",
"type": "ref"
},
"minLength": 1,
"type": "array"
},
"post": {
"format": "at-uri",
"type": "string"
},
"viaRepost": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"post",
"viaRepost",
"items"
],
"type": "object"
}
One actor who reposted the group's post via the requesting account's repost.
Properties
A decentralized identifier (DID).
View raw schema
{
"description": "One actor who reposted the group's post via the requesting account's repost.",
"properties": {
"actor": {
"format": "did",
"type": "string"
}
},
"required": [
"actor"
],
"type": "object"
}
An actor joined Bluesky via a starter pack created by the requesting account.
Properties
A decentralized identifier (DID).
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "An actor joined Bluesky via a starter pack created by the requesting account.",
"properties": {
"actor": {
"format": "did",
"type": "string"
},
"starterPack": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"actor",
"starterPack"
],
"type": "object"
}
Group of new posts by actors the requesting account subscribes to.
Properties
No description available.
minLength: 1 items
View raw schema
{
"description": "Group of new posts by actors the requesting account subscribes to.",
"properties": {
"items": {
"items": {
"ref": "#subscribedPostItem",
"type": "ref"
},
"minLength": 1,
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
}
One new post by an actor the requesting account subscribes to.
Properties
A decentralized identifier (DID).
An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).
View raw schema
{
"description": "One new post by an actor the requesting account subscribes to.",
"properties": {
"actor": {
"format": "did",
"type": "string"
},
"post": {
"format": "at-uri",
"type": "string"
}
},
"required": [
"actor",
"post"
],
"type": "object"
}
A verification of the requesting account was removed.
Properties
A decentralized identifier (DID).
View raw schema
{
"description": "A verification of the requesting account was removed.",
"properties": {
"actor": {
"format": "did",
"type": "string"
}
},
"required": [
"actor"
],
"type": "object"
}
An actor verified the requesting account.
Properties
A decentralized identifier (DID).
View raw schema
{
"description": "An actor verified the requesting account.",
"properties": {
"actor": {
"format": "did",
"type": "string"
}
},
"required": [
"actor"
],
"type": "object"
}