app.tempomusic.notification.getUnreadCount Documentation (EN)

main query

Count of unread notifications for the requesting viewer. The viewer DID is read from the service-auth JWT (`iss` claim) — no `?viewer=` query parameter.

Parameters

reasons array of string Optional

Reasons to include. Absent → post-liked, post-replied, reply-liked (the reasons that predate mentions, so clients unaware of newer reasons never receive a record they cannot decode). Unknown values are ignored; an empty set after filtering yields a count of 0.

Output

Encodingapplication/json

count integer Required

Number of notifications with indexedAt strictly newer than the recipient's stored seenAt (all notifications when seenAt is unset).

Try It

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

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

reasons Reasons to include. Absent → post-liked, post-replied, reply-liked (the reasons that predate mentions, so clients unaware of newer reasons never receive a record they cannot decode). Unknown values are ignored; an empty set after filtering yields a count of 0.

View raw schema

{
  "description": "Count of unread notifications for the requesting viewer. The viewer DID is read from the service-auth JWT (`iss` claim) — no `?viewer=` query parameter.",
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "count": {
          "description": "Number of notifications with indexedAt strictly newer than the recipient's stored seenAt (all notifications when seenAt is unset).",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "count"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "reasons": {
        "description": "Reasons to include. Absent → post-liked, post-replied, reply-liked (the reasons that predate mentions, so clients unaware of newer reasons never receive a record they cannot decode). Unknown values are ignored; an empty set after filtering yields a count of 0.",
        "items": {
          "maxLength": 100,
          "type": "string"
        },
        "maxLength": 10,
        "type": "array"
      }
    },
    "type": "params"
  },
  "type": "query"
}