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

# List notification guides

`GET /v1/notifications/guides`

## Request

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

## Query parameters

- `limit` integer
- `cursor` string
- `expectedUserId` string, uuid, required
- `locale` string, required
- `platform` 'web' | 'ios' | 'android', required

## Response `200`

Successful response

- NotificationGuidesOutput
  - `total` integer
  - `nextCursor` string
  - `previousCursor` string
  - `hasMore` boolean, required
  - `items` object[], required
    - `ref` string, required
    - `type` 'banner' | 'modal' | 'card', required
    - `content` object, required
    - `authoringOrigin` 'legacy' | 'native', required
    - `priority` integer, required
    - `key` string, required
    - `version` string, required
    - `name` string, required
    - `createdAt` string, date-time, required
    - `bypassGlobalGroupLimit` boolean, required
    - `seenAt` string, date-time, nullable, required
    - `interactedAt` string, date-time, nullable, required
  - `policy` object, required
    - `key` 'default', required
    - `displaySequence` string[], required
    - `displayIntervalSeconds` integer, nullable, required
    - `unthrottledGuideKeys` string[], required
    - `verified` boolean, required
    - `lastArchivedAt` string, date-time, nullable, required

## Other responses

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

## Changes

- **2026-10-26** `1c2780cd98a9`: 2 info
  - added the required property `items/items/authoringOrigin` to the response with the `200` status
  - added the required property `items/items/priority` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/legend/apis/legend-api/changes/v1/notifications/guides/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)