---
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`

## Request

- Base URL: `https://api.notifly.io`
- URL: `https://api.notifly.io/v1/subscribers/{subscriberId}/notifications/feed`
- Auth: API key in header `Authorization`

> **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

## Response `200`

OK

- object
  - `data` 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 Notifly 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.dev/notifly/apis/notifly-api.md) · [All operations](https://skmtc.dev/notifly/apis/notifly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/notifly/apis/notifly-api/revisions/af909b9e1e57?raw)