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

# List Notifications

`GET /notifications`

Paginated notification list for the current user, with actor display name.

## Query parameters

- `unread_only` boolean
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- ListNotificationsResponse
  - `notifications` NotificationResponse[], required
    - `id` string, required
    - `type` 'mention' | 'workspace_invite' | 'member_joined' | 'fork_created' | 'review_requested' | 'review_decision' | 'review_nudge' | 'review_retracted' | 'comment_new' | 'comment_reply', required — Types of in-app notifications.
    - `workspace_id` string, nullable, required
    - `actor_user_id` string, required
    - `actor_display_name` string, nullable
    - `entity_type` string, nullable, required
    - `entity_id` string, nullable, required
    - `payload` unknown, required
    - `read_at` string, date-time, nullable, required
    - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/tryscott/apis/one-shot-api.md) · [All operations](https://skmtc.dev/tryscott/apis/one-shot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryscott/one-shot-api/revisions/28bdface01df/schema)