app.bsky.notification.list Notifications

GET {{baseUrl}}/xrpc/app.bsky.notification.listNotifications?limit=50&priority=<boolean>&cursor=<string>&seenAt=<dateTime>

This endpoint is part of the Bluesky application Lexicon APIs (`app.bsky.`). Public endpoints which don't require authentication can be made directly against the public Bluesky AppView API: https://public.api.bsky.app. Authenticated requests are usually made to the user's PDS, with automatic service proxying. Authenticated requests can be used for both public and non-public endpoints.*

To learn more about calling atproto API endpoints like this one, see the API Hosts and Auth guide.

Enumerate notifications for the requesting account. Requires auth.

Request Params

HEADERS

RESPONSES

status: OK

{"notifications":[{"uri":"\u003cat-uri\u003e","cid":"\u003ccid\u003e","author":{"did":"\u003cdid\u003e","handle":"\u003chandle\u003e","displayName":"\u003cstring\u003e","description":"\u003cstring\u003e","avatar":"\u003curi\u003e","associated":{"lists":"\u003cinteger\u003e","feedgens":"\u003cinteger\u003e","starterPacks":"\u003cinteger\u003e","labeler":"\u003cboolean\u003e","chat":{"allowIncoming":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}},"indexedAt":"\u003cdateTime\u003e","createdAt":"\u003cdateTime\u003e","viewer":{"muted":"\u003cboolean\u003e","mutedByList":{"uri":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"cid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"listItemCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"labels":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"viewer":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"indexedAt":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"blockedBy":"\u003cboolean\u003e","blocking":"\u003cat-uri\u003e","blockingByList":{"uri":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"cid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"listItemCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"labels":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"viewer":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"indexedAt":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"following":"\u003cat-uri\u003e","followedBy":"\u003cat-uri\u003e","knownFollowers":{"count":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"followers":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}},"labels":[{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"},{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"}]},"reason":"\u003cstring\u003e","record":{},"isRead":"\u003cboolean\u003e","indexedAt":"\u003cdateTime\u003e","reasonSubject":"\u003cat-uri\u003e","labels":[{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"},{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"}]},{"uri":"\u003cat-uri\u003e","cid":"\u003ccid\u003e","author":{"did":"\u003cdid\u003e","handle":"\u003chandle\u003e","displayName":"\u003cstring\u003e","description":"\u003cstring\u003e","avatar":"\u003curi\u003e","associated":{"lists":"\u003cinteger\u003e","feedgens":"\u003cinteger\u003e","starterPacks":"\u003cinteger\u003e","labeler":"\u003cboolean\u003e","chat":{"allowIncoming":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}},"indexedAt":"\u003cdateTime\u003e","createdAt":"\u003cdateTime\u003e","viewer":{"muted":"\u003cboolean\u003e","mutedByList":{"uri":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"cid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"listItemCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"labels":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"viewer":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"indexedAt":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"blockedBy":"\u003cboolean\u003e","blocking":"\u003cat-uri\u003e","blockingByList":{"uri":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"cid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"purpose":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"avatar":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"listItemCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"labels":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"viewer":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"indexedAt":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"following":"\u003cat-uri\u003e","followedBy":"\u003cat-uri\u003e","knownFollowers":{"count":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"followers":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}},"labels":[{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"},{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"}]},"reason":"\u003cstring\u003e","record":{},"isRead":"\u003cboolean\u003e","indexedAt":"\u003cdateTime\u003e","reasonSubject":"\u003cat-uri\u003e","labels":[{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"},{"src":"\u003cdid\u003e","uri":"\u003curi\u003e","val":"\u003cstring\u003e","cts":"\u003cdateTime\u003e","ver":"\u003cinteger\u003e","cid":"\u003ccid\u003e","neg":"\u003cboolean\u003e","exp":"\u003cdateTime\u003e","sig":"\u003cbyte\u003e"}]}],"cursor":"\u003cstring\u003e","priority":"\u003cboolean\u003e","seenAt":"\u003cdateTime\u003e"}