Notifications

List Notifications

Changed on

Retrieve a list of Event Notifications for the specified Organization.

This endpoint retrieves a list of all Event Notifications for the Organization identified by its UUID. The list can be paginated for easier management. The list also supports filtering by parameters such as Notification UUID.

get/organizations/{orgId}/notifications/configurations

Request

Path parameters

orgIdstring required

The unique identifier (UUID) of your Organization. The Organization represents your company as a direct customer of our service.

Query parameters

pageSizeinteger

Specifies the maximum number of Notifications to retrieve per page.

nextTokenstring

The nextToken for multi-page retrievals. It is used to fetch the next page of Notifications in a paginated list.

activeboolean

A Boolean flag indicating whether to retrieve only active or only inactive Notifications.

  • TRUE - only active Notifications are returned.
  • FALSE - only inactive Notifications are returned.
eventNamestring

Use this to filter the Notifications returned - only those Notifications that are based on the Event type specified by eventName are returned.

idsobject[]

A list of specific Notification UUIDs to retrieve.

Response

Returns the list of Event Notifications

nextTokenstring

Example response

{
  "data": [
    {
      "name": "Commitment has under 10% remaining",
      "description": "Commitment amount fell below 10%",
      "active": true,
      "eventName": "configuration.commitment.updated",
      "calculation": "(new.amountSpent >= ((new.amount*90)/100)) \nAND ((old.amountSpent <= ((old.amount*90)/100)) OR (old.amountSpent == null))",
      "code": "commitment_under_10_percent"
    }
  ]
}

Changes

    • breaking

      for the query request parameter ids, the type of property items/ was specialized from string to object

    • breaking

      the ////// response's property type changed from no type to object for status

    • breaking

      the // response's property type changed from no type to object for status

    • breaking

      the response's body type changed from no type to object for status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status