---
title: "Get Notification Stats Endpoint"
method: GET
path: "/notifications/stats"
tags: ["Notifications", "notifications"]
---

# Get Notification Stats Endpoint

`GET /notifications/stats`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/notifications/stats`
- Auth: HTTP bearer

Get notification counts for the surface's filter tabs.

**Returns:**
- `total`: total notifications
- `unread`: unread count
- `by_category`: per-category counts (invites, teams, publishing, social,
  alerts, system). Unfiltered, so the pills show global totals.

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Response `200`

Successful Response

- NotificationStatsResponse: Response model for the notification stats endpoint (tab badges). by_category counts are unfiltered (across the user's whole inbox) so the filter pills show global totals, not page-local ones. A notification may count toward more than one category (see NOTIFICATION_CATEGORIES).
  - `total` integer, required
  - `unread` integer, required
  - `by_category` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jubjubapp/apis/jubjub-api.md) - [All operations](https://skmtc.dev/jubjubapp/apis/jubjub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jubjubapp/apis/jubjub-api/revisions/353157b296f2?raw)