app.bsky.notification.listNotifications

Domain Index: bsky.app

Crawl History

#main - query

Enumerate notifications for the requesting account. Requires auth.

Query Parameters

Name Type Details
cursor string
limit integer

Default: 50

Minimum: 1

Maxumum:

priority boolean
reasons array

Notification reasons to include in response.

UNHANDLED IN ARRAYS: string

seenAt string

Syntax Format: datetime

Response Body

Content Type: application/json

Data Fields

Name Type Details
cursor string
notifications array (required)

Elements are of type:

priority boolean
seenAt string

Syntax Format: datetime

Errors

No error types defined

#notification - object

Data Fields

Name Type Details
author ref (required)

Reference: app.bsky.actor.defs#profileView

cid string (required)

Syntax Format: cid

indexedAt string (required)

Syntax Format: datetime

isRead boolean (required)
labels array

Elements are of type:

reason string (required)

Expected values are 'like', 'repost', 'follow', 'mention', 'reply', 'quote', and 'starterpack-joined'.

Known Values: like, repost, follow, mention, reply, quote, starterpack-joined,

reasonSubject string

Syntax Format: at-uri

record unknown (required) Field can contain arbitrary JSON/CBOR object data
uri string (required)

Syntax Format: at-uri