list notification events by entity

GET https://api.suger.cloud/org/{orgId}/notificationEvent/{entityType}/{entityId}

List the notification events of the given organization and entity with pagination.

Parameters

Name	In	Type	Required	Description
`orgId`	path	string	yes	Organization ID
`entityType`	path	string	yes	Entity type, valid values are: PRODUCT, OFFER, ENTITLEMENT, INTEGRATION etc.
`entityId`	path	string	yes	Entity ID
`limit`	query	integer	no	List pagination size, default 1000, max value is 1000
`offset`	query	integer	no	List pagination offset, default 0

Responses

200 — OK

Content-Type: application/json · Schema: ListNotificationEventsResponse

ListNotificationEventsResponse fields:

Field	Type	Required	Description
`nextOffset`	integer	no	If it is nil, it means there is no more records.
`notificationEvents`	array<NotificationEvent>	no
`totalCount`	integer	no	Only available when the request is made with offset=0.

NotificationEvent fields:

Field	Type	Required	Description
`action`	NotificationEventAction	no
`ccContactIds`	array<string>	no	Cc contactIds that will receive this notification
`channels`	array<NotificationChannel>	no	Channels lists where this event is delivered, e.g., ["SLACK", "EMAIL"]. Empty + RequireAudit=true means audit-only: the event reaches the Activity timeline but no outbound channel. Delivery handlers MUST gate their Match on Channels for that contract to hold.
`contactEmails`	array<string>	no	Contact emails that will receive this notification
`contactIds`	array<string>	no	ContactIds that will receive this notification
`createdBy`	LastModifiedBy	no
`customFields`	object	no	Custom fields of the notification event.
`entityID`	string	no
`entityName`	string	no	The name of the entity.
`entityStatus`	string	no
`entityType`	EntityType	no
`eventID`	string	no	notification event id.
`eventStatus`	NotificationEventStatus	no
`info`	object	no	Additional info of the notification event.
`isActionItem`	boolean	no	If this notification event is an action item.
`lastUpdateTime`	string	no	timestamp of the event when it is updated.
`message`	string	no	The message of the notification event such as email body, action item description.
`organizationID`	string	no	suger organization id.
`partner`	Partner	no
`priority`	AuditingEventPriority	no
`requireAudit`	boolean	no	If this notification event is an auditing event and need to store in DB.
`timestamp`	string	no	timestamp of the event when it is scheduled or created.
`title`	string	no	The title of the notification event such as email subject, action item title.
`trackEvents`	array<TrackEvent>	no	The track events of the notification event.
`version`	integer	no	Version identifies the schema version of this envelope. Consumers reject unknown versions (leave for redelivery to DLQ) so a future shape change doesn't silently poison old consumers. Missing/0 → v1 (default).

LastModifiedBy fields:

Field	Type	Required	Description
`email`	string	no	The email of the creator.
`entityId`	string	no	The ID of the creator.
`entityType`	EntityType	no
`name`	string	no	The name of the creator.

TrackEvent fields:

Field	Type	Required	Description
`action`	TrackEventActionType	no
`contactId`	string	no	The ID of the contact who triggered the track event if applicable.
`timestamp`	string	no	timestamp of the track event happened.

400 — Bad request error

Content-Type: application/json

500 — Internal server error

Content-Type: application/json

View as Markdown · Interactive API reference

Spotted something wrong or out of date on this page? Tell us and we'll correct it.