---
title: "Retrieve subscriber notifications"
method: GET
path: "/v1/subscribers/{subscriberId}/notifications/feed"
tags: ["Subscribers"]
deprecated: true
---

# Retrieve subscriber notifications

`GET /v1/subscribers/{subscriberId}/notifications/feed`

> **Deprecated.**

This API is deprecated, use v2 API instead. Retrieve subscriber in-app notifications by its unique key identifier **subscriberId**.

## Path parameters

- `subscriberId` string, required

## Query parameters

- `page` number
- `limit` number
- `read` boolean
- `seen` boolean
- `payload` string

## Headers

- `idempotency-key` string

## Response `200`

OK

- FeedResponseDto
  - `totalCount` number — Total number of notifications available.
  - `hasMore` boolean, required — Indicates if there are more notifications to load.
  - `data` NotificationFeedItemDto[], required — Array of notifications returned in the response.
    - `_id` string, required — Unique identifier for the notification.
    - `_templateId` string, required — Identifier for the template used to generate the notification.
    - `_environmentId` string, required — Identifier for the environment where the notification is sent.
    - `_messageTemplateId` string — Identifier for the message template used.
    - `_organizationId` string, required — Identifier for the organization sending the notification.
    - `_notificationId` string, required — Unique identifier for the notification instance.
    - `_subscriberId` string, required — Unique identifier for the subscriber receiving the notification.
    - `_feedId` string, nullable — Identifier for the feed associated with the notification.
    - `_jobId` string, required — Identifier for the job that triggered the notification.
    - `createdAt` string, date-time, nullable — Timestamp indicating when the notification was created.
    - `updatedAt` string, date-time, nullable — Timestamp indicating when the notification was last updated.
    - `actor` ActorFeedItemDto
      - `data` string, nullable, required — The data associated with the actor, can be null if not applicable.
      - `type` 'none' | 'user' | 'system_icon' | 'system_custom', required — The type of the actor, indicating the role in the notification process.
    - `subscriber` SubscriberFeedResponseDto
      - `_id` string — The internal ID generated by Novu for your subscriber. This ID does not match the `subscriberId` used in your queries. Refer to `subscriberId` for that identifier.
      - `firstName` string — The first name of the subscriber.
      - `lastName` string — The last name of the subscriber.
      - `avatar` string — The URL of the subscriber's avatar image.
      - `subscriberId` string, required — The identifier used to create this subscriber, which typically corresponds to the user ID in your system.
    - `transactionId` string, required — Unique identifier for the transaction associated with the notification.
    - `templateIdentifier` string, nullable — Identifier for the template used, if applicable.
    - `providerId` string, nullable — Identifier for the provider that sends the notification.
    - `content` string, required — The main content of the notification.
    - `subject` string, nullable — The subject line for email notifications, if applicable.
    - `channel` 'in_app' | 'email' | 'sms' | 'chat' | 'push' | 'tool', required — Channel type through which the message is sent
    - `read` boolean, required — Indicates whether the notification has been read by the subscriber.
    - `seen` boolean, required — Indicates whether the notification has been seen by the subscriber.
    - `archived` boolean, required — Indicates whether the notification has been archived by the subscriber.
    - `deviceTokens` string[], nullable — Device tokens for push notifications, if applicable.
    - `cta` MessageCTA, required
      - `type` 'redirect' — Type of call to action
      - `data` MessageCTAData
        - `url` string — URL for the call to action
      - `action` MessageAction
        - `status` 'pending' | 'done' — Status of the message action
        - `buttons` MessageButton[] — List of buttons associated with the message action
          - `type` 'primary' | 'secondary', required — Type of button for the action result
          - `content` string, required — Content of the button
          - `resultContent` string — Content of the result when the button is clicked
        - `result` MessageActionResult
          - `payload` object — Payload of the action result
          - `type` 'primary' | 'secondary' — Type of button for the action result
    - `status` 'sent' | 'error' | 'warning', required — Current status of the notification.
    - `payload` object — The payload that was used to send the notification trigger.
    - `data` object, nullable — The data sent with the notification.
    - `overrides` object — Provider-specific overrides used when triggering the notification.
    - `tags` string[], nullable — Tags associated with the workflow that triggered the notification.
  - `pageSize` number, required — The number of notifications returned in this response.
  - `page` number, required — The current page number of the notifications.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `413` — Payload Too Large
- `414` — URI Too Long
- `415` — Unsupported Media Type
- `422` — Unprocessable Entity
- `429` — The client has sent too many requests in a given amount of time.
- `500` — Internal Server Error
- `503` — The server is currently unable to handle the request due to a temporary overload or scheduled maintenance, which will likely be alleviated after some delay.

---

[API](https://skmtc.net/novu/apis/novu-api.md) · [All operations](https://skmtc.net/novu/apis/novu-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novu/novu-api/versions/e4a270f838f0/schema)