Backfill in-progress. Some lexicons and records may be missing or incomplete.

app.bsky.notification.listNotifications

bsky-lexicons.bsky.social

Documentation

main query

Enumerate notifications for the requesting account. Requires auth.

Parameters

cursor string Optional

No description provided.

limit integer Optional

No description provided.

priority boolean Optional

No description provided.

reasons array of string Optional

Notification reasons to include in response.

seenAt string datetime Optional

An RFC 3339 formatted timestamp.

Output

Encodingapplication/json
cursor string Optional

No description provided.

notifications array Required

No description provided.

priority boolean Optional

No description provided.

seenAt stringdatetime Optional

An RFC 3339 formatted timestamp.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Notification reasons to include in response.
An RFC 3339 formatted timestamp.
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "notifications"
      ],
      "properties": {
        "cursor": {
          "type": "string"
        },
        "seenAt": {
          "type": "string",
          "format": "datetime"
        },
        "priority": {
          "type": "boolean"
        },
        "notifications": {
          "type": "array",
          "items": {
            "ref": "#notification",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 50,
        "maximum": 100,
        "minimum": 1
      },
      "cursor": {
        "type": "string"
      },
      "seenAt": {
        "type": "string",
        "format": "datetime"
      },
      "reasons": {
        "type": "array",
        "items": {
          "type": "string",
          "description": "A reason that matches the reason property of #notification."
        },
        "description": "Notification reasons to include in response."
      },
      "priority": {
        "type": "boolean"
      }
    }
  },
  "description": "Enumerate notifications for the requesting account. Requires auth."
}
notification object

Properties

cid string cid Required

A content identifier (CID) referencing immutable data.

indexedAt string datetime Required

An RFC 3339 formatted timestamp.

isRead boolean Required

No description provided.

reason string Required

The reason why this notification was delivered - e.g. your post was liked, or you received a new follower.

Known values: like, repost, follow, mention, reply, quote, starterpack-joined, verified, unverified, like-via-repost, repost-via-repost, subscribed-post, contact-match
reasonSubject string at-uri Optional

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

record unknown Required

No description provided.

uri string at-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

View raw schema 
{
  "type": "object",
  "required": [
    "uri",
    "cid",
    "author",
    "reason",
    "record",
    "isRead",
    "indexedAt"
  ],
  "properties": {
    "cid": {
      "type": "string",
      "format": "cid"
    },
    "uri": {
      "type": "string",
      "format": "at-uri"
    },
    "author": {
      "ref": "app.bsky.actor.defs#profileView",
      "type": "ref"
    },
    "isRead": {
      "type": "boolean"
    },
    "labels": {
      "type": "array",
      "items": {
        "ref": "com.atproto.label.defs#label",
        "type": "ref"
      }
    },
    "reason": {
      "type": "string",
      "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"
      ]
    },
    "record": {
      "type": "unknown"
    },
    "indexedAt": {
      "type": "string",
      "format": "datetime"
    },
    "reasonSubject": {
      "type": "string",
      "format": "at-uri"
    }
  }
}

Lexicon Garden

@