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

# List notifications

`GET /api/notifications`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/notifications`
- Auth: HTTP bearer

List your in-app notifications with cursor-based pagination. Includes deal events, listing updates, and system alerts.

Requires `notifications:read` scope.

A notification written before mail subjects were redacted at write time reads with the subject of authentication mail redacted, in `body` and `data.subject`, for a token without `email:auth_secrets`.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

List of notifications

- object
  - `notifications` object[]
    - `id` string
    - `type` string
    - `title` string
    - `body` string
    - `action_url` string, nullable
    - `read` boolean
    - `created_at` string, date-time
  - `has_more` boolean
  - `next_cursor` string, nullable

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)