# app.zeens.notification.getUnreadCount

> Published by [zeens.app](https://lexicon.garden/identity/did:plc:pwpuqwge6g7xrjmfbw73uycw)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.notification.getUnreadCount)
- [Documentation](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.notification.getUnreadCount/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:pwpuqwge6g7xrjmfbw73uycw/app.zeens.notification.getUnreadCount/examples)

## Definitions

### `app.zeens.notification.getUnreadCount`

**Type**: `query`

Get the count of unread notifications for a Zeens user (count newer than the user's seenAt cursor).

#### Parameters

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `actors` | `string` | Yes | Required comma-separated allowlist of author DIDs (the Zeens membership set). Only notifications authored by one of these DIDs are counted, so activity from Bluesky or another atproto client never drives the badge. An empty list counts zero. |
| `recipient` | `string` (did) | Yes |  |

#### Output

**Encoding**: `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `count` | `integer` | Yes |  |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Get the count of unread notifications for a Zeens user (count newer than the user's seenAt cursor).",
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "count": {
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "count"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "actors": {
            "description": "Required comma-separated allowlist of author DIDs (the Zeens membership set). Only notifications authored by one of these DIDs are counted, so activity from Bluesky or another atproto client never drives the badge. An empty list counts zero.",
            "type": "string"
          },
          "recipient": {
            "format": "did",
            "type": "string"
          }
        },
        "required": [
          "recipient",
          "actors"
        ],
        "type": "params"
      },
      "type": "query"
    }
  },
  "id": "app.zeens.notification.getUnreadCount",
  "lexicon": 1
}
```