---
title: "List the current user's stored notifications"
method: GET
path: "/notifications"
tags: ["Notifications"]
---

# List the current user's stored notifications

`GET /notifications`

## Request

- Base URL: `https://app.openpo.st/api/v1`
- URL: `https://app.openpo.st/api/v1/notifications`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `openpost_session`

## Query parameters

- `workspace_id` string, required: Workspace whose inbox should be listed
- `cursor` string: Opaque pagination cursor
- `limit` integer

## Response `200`

OK

- NotificationPage
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `items` UserNotification[], nullable, required
    - `actions` NotificationAction[], nullable
      - `href` string
      - `kind` string
      - `label` string, required
      - `operation` string
      - `target_id` string
    - `body` string, required
    - `created_at` string, date-time, required
    - `href` string, required
    - `id` string, required
    - `payload_json` string, required
    - `read_at` string, date-time
    - `title` string, required
    - `type` string, required
    - `user_id` string, required
    - `workspace_id` string, required
  - `next_cursor` string
  - `unread_count` integer, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openpo/apis/openpost-api.md) · [All operations](https://skmtc.dev/openpo/apis/openpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openpo/apis/openpost-api/revisions/67d3964458a7?raw)