---
title: "List notification feed"
method: GET
path: "/v1/notifications/feed"
tags: ["notifications"]
---

# List notification feed

`GET /v1/notifications/feed`

## Request

- Base URL: `https://app.legend.trade/api/rest`
- URL: `https://app.legend.trade/api/rest/v1/notifications/feed`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string
- `feed` 'general' | 'chat' | 'announcements'
- `workflow` string
- `expectedUserId` string, uuid

## Response `200`

Successful response

- NotificationFeedOutput
  - `items` object[], required
    - `id` string, uuid, required
    - `eventId` string, uuid, required
    - `workflow` string, required
    - `feed` 'general' | 'chat' | 'announcements', required
    - `data` object, required
    - `createdAt` string, date-time, required
    - `presentation` object, nullable
      - `body` string, required
      - `actionUrl` string, required
      - `categories` string[], required
    - `actorIds` string[], required
    - `actors` object[], required
      - `id` string, uuid, required
      - `name` string, nullable, required
      - `avatar` string, nullable, required
    - `readAt` string, date-time, nullable, required
    - `archivedAt` string, date-time, nullable, required
  - `nextCursor` string, nullable, required
  - `hasMore` boolean, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

## Changes

- **2026-10-25** `8d368659667e`: 3 breaking, 6 info
  - the response property `items/items/actors/items/avatar` became nullable for the status `200`
  - the response property `items/items/actors/items/name` became nullable for the status `200`
  - the response property `nextCursor` became nullable for the status `200`
  - response property `items/items/actors/items/avatar` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - …5 more
- **2026-10-22** `71524db9527a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/legend/apis/legend-api/changes/v1/notifications/feed/get.md)

---

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