NOnovu
Subscribers

Retrieve subscriber notifications

Changed on

Retrieve in-app (inbox) notifications for a subscriber by its unique key identifier subscriberId. Supports filtering by tags, read/archived/snoozed/seen state, data attributes, severity, date range, and context keys.

get/v2/subscribers/{subscriberId}/notifications

Request

  • Base URL
    https://api.novu.co
  • Auth
    API key in header Authorization

Path parameters

subscriberIdstring required

The identifier of the subscriber

Query parameters

limitnumber
Example:10
afterstring
offsetnumber
tagsstring[]

Filter by workflow tags. Returns notifications that have any of the given tags.

readboolean

Filter by read/unread state

archivedboolean

Filter by archived state

snoozedboolean

Filter by snoozed state

seenboolean

Filter by seen state

datastring

Filter by data attributes (JSON string)

severitystring[]

Filter by severity levels

createdGtenumber
Example:1704067200000

Filter notifications created on or after this timestamp (Unix timestamp in milliseconds)

createdLtenumber
Example:1735689599999

Filter notifications created on or before this timestamp (Unix timestamp in milliseconds)

contextKeysstring[]

Context keys for filtering notifications in multi-context scenarios

Headers

idempotency-keystring

A header for idempotency purposes

Response

OK

hasMoreboolean required

Indicates if there are more notifications available

filterobject required

The filter applied to the notifications

Changes