social.colibri.beta.notification.getUnreadCount Documentation (EN)

main query

Gets how many of the requesting user's notifications are unread.

Output

Encodingapplication/json

count integer Required

Number of unread notifications.

Errors

AuthRequired The request has no valid service auth.

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)

View raw schema

{
  "description": "Gets how many of the requesting user's notifications are unread.",
  "errors": [
    {
      "description": "The request has no valid service auth.",
      "name": "AuthRequired"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "count": {
          "description": "Number of unread notifications.",
          "type": "integer"
        }
      },
      "required": [
        "count"
      ],
      "type": "object"
    }
  },
  "type": "query"
}