---
title: "List notifications"
method: GET
path: "/notifications"
tags: ["Notifications"]
---

# List notifications

`GET /notifications`

Newest 50 notifications for the organization, with the calling user's read state. `meta.unread` counts unread among those 50.

## Response `200`

Notifications

- object
  - `data` object[], required
    - `id` string, required
    - `severity` 'info' | 'success' | 'warning' | 'error', required
    - `title` string, required
    - `body` string, required
    - `href` string, nullable, required — Dashboard path this notification links to
    - `actionLabel` string, nullable, required — Button text for the linked action, e.g. "Update payment"; null when there is nothing to do
    - `requiresAck` boolean, required — Shown once in a modal until read
    - `read` boolean, required — Whether the calling user has read it
    - `createdAt` number, required — Unix ms
  - `meta` object, required
    - `unread` integer, required

## Other responses

- `401` — Unauthorized

## Changes

- **2026-09-26** `fc5ca5f06d15` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rendobar/apis/rendobar-api/changes/notifications/get.md)

---

[API](https://skmtc.dev/rendobar/apis/rendobar-api.md) · [All operations](https://skmtc.dev/rendobar/apis/rendobar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rendobar/apis/rendobar-api/revisions/421a5a241a64?raw)