Skip to main content

app.bsky.notification.listNotifications

GET 
app.bsky.notification.listNotifications

Enumerate notifications for the requesting account. Requires auth.

Request​

Query Parameters

    limit integer

    Possible values: >= 1 and <= 100

    Default value: 50

    cursor string
    seenAt date-time

Responses​

OK

Schema

    cursor string

    notifications

    object[]

    required

  • Array [

    • uri at-urirequired
    cid cidrequired

    author

    object

    required

    did didrequired
    handle handlerequired
    displayName string

    Possible values: <= 640 characters

    description string

    Possible values: <= 2560 characters

    avatar uri

    associated

    object

    lists integer
    feedgens integer
    labeler boolean

    chat

    object

    allowIncoming stringrequired

    Possible values: [all, none, following]

    indexedAt date-time

    viewer

    object

    Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.

    muted boolean

    mutedByList

    object

    uri at-urirequired
    cid cidrequired
    name stringrequired

    Possible values: non-empty and <= 64 characters

    purpose

    object

    required

    oneOf

    string

    avatar uri

    labels

    object[]

  • Array [

    • ver integer
    src didrequired

    DID of the actor who created this label.

    uri urirequired

    AT URI of the record, repository (account), or other resource that this label applies to.

    cid cid

    Optionally, CID specifying the specific version of 'uri' resource this label applies to.

    val stringrequired

    Possible values: <= 128 characters

    The short string name of the value or type of this label.

    neg boolean

    If true, this is a negation label, overwriting a previous label.

    cts date-timerequired

    Timestamp when this label was created.

    exp date-time

    Timestamp at which this label expires (no longer applies).

    sig byte

    Signature of dag-cbor encoded label.

  • ]

    • viewer

    object

    muted boolean
    blocked at-uri
    indexedAt date-time
    blockedBy boolean
    blocking at-uri

    blockingByList

    object

    uri at-urirequired
    cid cidrequired
    name stringrequired

    Possible values: non-empty and <= 64 characters

    purpose

    object

    required

    oneOf

    string

    avatar uri

    labels

    object[]

  • Array [

    • ver integer
    src didrequired

    DID of the actor who created this label.

    uri urirequired

    AT URI of the record, repository (account), or other resource that this label applies to.

    cid cid

    Optionally, CID specifying the specific version of 'uri' resource this label applies to.

    val stringrequired

    Possible values: <= 128 characters

    The short string name of the value or type of this label.

    neg boolean

    If true, this is a negation label, overwriting a previous label.

    cts date-timerequired

    Timestamp when this label was created.

    exp date-time

    Timestamp at which this label expires (no longer applies).

    sig byte

    Signature of dag-cbor encoded label.

  • ]

    • viewer

    object

    muted boolean
    blocked at-uri
    indexedAt date-time
    following at-uri
    followedBy at-uri

    labels

    object[]

  • Array [

    • ver integer
    src didrequired

    DID of the actor who created this label.

    uri urirequired

    AT URI of the record, repository (account), or other resource that this label applies to.

    cid cid

    Optionally, CID specifying the specific version of 'uri' resource this label applies to.

    val stringrequired

    Possible values: <= 128 characters

    The short string name of the value or type of this label.

    neg boolean

    If true, this is a negation label, overwriting a previous label.

    cts date-timerequired

    Timestamp when this label was created.

    exp date-time

    Timestamp at which this label expires (no longer applies).

    sig byte

    Signature of dag-cbor encoded label.

  • ]

    • reason stringrequired

    Possible values: [like, repost, follow, mention, reply, quote]

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

    reasonSubject at-uri
    record required
    isRead booleanrequired
    indexedAt date-timerequired

    labels

    object[]

  • Array [

    • ver integer
    src didrequired

    DID of the actor who created this label.

    uri urirequired

    AT URI of the record, repository (account), or other resource that this label applies to.

    cid cid

    Optionally, CID specifying the specific version of 'uri' resource this label applies to.

    val stringrequired

    Possible values: <= 128 characters

    The short string name of the value or type of this label.

    neg boolean

    If true, this is a negation label, overwriting a previous label.

    cts date-timerequired

    Timestamp when this label was created.

    exp date-time

    Timestamp at which this label expires (no longer applies).

    sig byte

    Signature of dag-cbor encoded label.

  • ]

  • ]

    • seenAt date-time
Loading...