Docs

Get Notifications

GET /notifications?organizationId={organizationId}

GET/notifications?organizationId={organizationId}

Returns all notifications for the authenticated user, optionally scoped to a specific organization or event. Notifications are inbox items generated when a subscribed subject produces an event that matches the user's preferences.

Required Tokens

FieldTypeRequiredDescription
BearerAuthorization: Bearer <token>OptionalAuthenticate via OAuth2 in Bruno.

Query Parameters

FieldTypeRequiredDescription
organizationIdGuidOptionalFilter notifications to a specific organization.
eventIdGuidOptionalFilter notifications to a specific event.

Response

Returns a list of notification objects.

FieldTypeDescription
idGuidUnique notification ID.
occurredAtDateTimeWhen the triggering event occurred.
readAtDateTime| nullWhen the notification was read. Null if unread.
subjectTypestringType of the subject that produced the notification (e.g. Area, Task).
subjectIdGuidID of the subject entity.
organizationIdGuidOrganization context.
eventIdGuid| nullEvent context. Null for org-level notifications.
eventTypestringThe domain event type that triggered the notification.
titlestringShort notification title.
bodystringFull notification body text.