Notification¶

Notification - Get¶

HTTP Request

GET /api/v1/notification/{id}

📋 Description: Retrieves the details of a specific notification by its unique identifier, enabling users to access important updates and alerts relevant to their operations.

Parameters

Name	In	Type	Required	Description
id	path	integer(int64)	true	Unique identifier for the resource

Responses

Status	Meaning	Description	Schema
200	OK	OK	ResponseNotificationDto

Example Responses

{
  "code": "UPDATED",
  "errors": {
    "all": [
      {
        "type": "GENERIC",
        "errorMessage": "string",
        "source": {},
        "field": "string",
        "errorKey": "string"
      }
    ]
  },
  "object": {
    "id": 0,
    "subscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE",
      "captionKey": "string",
      "en_message": "string",
      "fr_message": "string",
      "url": "string",
      "parameters": [
        {
          "name": "string",
          "dataType": "NUMBER",
          "value": "string"
        }
      ],
      "onlyAfterNow": true,
      "startTime": "2019-08-24T14:15:22Z",
      "cronExpression": "string",
      "endTime": "2019-08-24T14:15:22Z",
      "content": "string"
    },
    "unsubscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE"
    },
    "scheduledTime": "2019-08-24T14:15:22Z",
    "user": {
      "id": 0,
      "accountId": 0,
      "fullName": "string",
      "firstName": "string",
      "lastName": "string",
      "username": "string",
      "email": "string",
      "accountName": "string",
      "profile": "string"
    },
    "state": "ACTIVE",
    "status": "UNREAD"
  }
}

Notification - Update¶

HTTP Request

PUT /api/v1/notification/{id}

📋 Description: Updates the details of a specific notification identified by its unique ID, allowing businesses to manage and modify notification content as needed.

Parameters

Name	In	Type	Required	Description
id	path	integer(int64)	true	Unique identifier for the resource
body	body	NotificationDto	true	Request body containing the updated notification details, including title, message, and status, to ensure accurate communication with stakeholders.

Body Parameters

{
  "id": 0,
  "subscribeMessage": {
    "id": 0,
    "targetId": "string",
    "targetType": "string",
    "topicApplication": "NFS",
    "topicName": "string",
    "topicPriority": "HIGH",
    "topicEnCaption": "string",
    "topicFrCaption": "string",
    "username": "string",
    "action": "SUBSCRIBE",
    "captionKey": "string",
    "en_message": "string",
    "fr_message": "string",
    "url": "string",
    "parameters": [
      {
        "name": "string",
        "dataType": "NUMBER",
        "value": "string"
      }
    ],
    "onlyAfterNow": true,
    "startTime": "2019-08-24T14:15:22Z",
    "cronExpression": "string",
    "endTime": "2019-08-24T14:15:22Z",
    "content": "string"
  },
  "unsubscribeMessage": {
    "id": 0,
    "targetId": "string",
    "targetType": "string",
    "topicApplication": "NFS",
    "topicName": "string",
    "topicPriority": "HIGH",
    "topicEnCaption": "string",
    "topicFrCaption": "string",
    "username": "string",
    "action": "SUBSCRIBE"
  },
  "scheduledTime": "2019-08-24T14:15:22Z",
  "user": {
    "id": 0,
    "accountId": 0,
    "fullName": "string",
    "firstName": "string",
    "lastName": "string",
    "username": "string",
    "email": "string",
    "accountName": "string",
    "profile": "string"
  },
  "state": "ACTIVE",
  "status": "UNREAD"
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	ResponseNotificationDto

Example Responses

{
  "code": "UPDATED",
  "errors": {
    "all": [
      {
        "type": "GENERIC",
        "errorMessage": "string",
        "source": {},
        "field": "string",
        "errorKey": "string"
      }
    ]
  },
  "object": {
    "id": 0,
    "subscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE",
      "captionKey": "string",
      "en_message": "string",
      "fr_message": "string",
      "url": "string",
      "parameters": [
        {
          "name": "string",
          "dataType": "NUMBER",
          "value": "string"
        }
      ],
      "onlyAfterNow": true,
      "startTime": "2019-08-24T14:15:22Z",
      "cronExpression": "string",
      "endTime": "2019-08-24T14:15:22Z",
      "content": "string"
    },
    "unsubscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE"
    },
    "scheduledTime": "2019-08-24T14:15:22Z",
    "user": {
      "id": 0,
      "accountId": 0,
      "fullName": "string",
      "firstName": "string",
      "lastName": "string",
      "username": "string",
      "email": "string",
      "accountName": "string",
      "profile": "string"
    },
    "state": "ACTIVE",
    "status": "UNREAD"
  }
}

Notification - Patch¶

HTTP Request

PATCH /api/v1/notification/{id}

📋 Description: Updates the specified notification identified by its unique ID, allowing for modifications to notification details to enhance communication effectiveness within the organization.

Parameters

Name	In	Type	Required	Description
id	path	integer(int64)	true	Unique identifier for the resource
body	body	JsonPatch	true	Request body containing the updated notification details, including status and relevant metadata, to modify the specified notification identified by the provided ID.

Body Parameters

1{}

Responses

Status	Meaning	Description	Schema
200	OK	OK	ResponseNotificationDto

Example Responses

{
  "code": "UPDATED",
  "errors": {
    "all": [
      {
        "type": "GENERIC",
        "errorMessage": "string",
        "source": {},
        "field": "string",
        "errorKey": "string"
      }
    ]
  },
  "object": {
    "id": 0,
    "subscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE",
      "captionKey": "string",
      "en_message": "string",
      "fr_message": "string",
      "url": "string",
      "parameters": [
        {
          "name": "string",
          "dataType": "NUMBER",
          "value": "string"
        }
      ],
      "onlyAfterNow": true,
      "startTime": "2019-08-24T14:15:22Z",
      "cronExpression": "string",
      "endTime": "2019-08-24T14:15:22Z",
      "content": "string"
    },
    "unsubscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE"
    },
    "scheduledTime": "2019-08-24T14:15:22Z",
    "user": {
      "id": 0,
      "accountId": 0,
      "fullName": "string",
      "firstName": "string",
      "lastName": "string",
      "username": "string",
      "email": "string",
      "accountName": "string",
      "profile": "string"
    },
    "state": "ACTIVE",
    "status": "UNREAD"
  }
}

Notification - Bulk Update¶

HTTP Request

PUT /api/v1/notification/bulk

📋 Description: Updates multiple notification records in bulk, allowing for efficient management of notifications across the system.

Parameters

Name	In	Type	Required	Description
body	body	NotificationDto	true	Request body containing an array of notification objects, each including relevant details such as recipient information, message content, and delivery preferences for bulk notification management.

Body Parameters

[
  {
    "id": 0,
    "subscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE",
      "captionKey": "string",
      "en_message": "string",
      "fr_message": "string",
      "url": "string",
      "parameters": [
        {
          "name": "string",
          "dataType": "NUMBER",
          "value": "string"
        }
      ],
      "onlyAfterNow": true,
      "startTime": "2019-08-24T14:15:22Z",
      "cronExpression": "string",
      "endTime": "2019-08-24T14:15:22Z",
      "content": "string"
    },
    "unsubscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE"
    },
    "scheduledTime": "2019-08-24T14:15:22Z",
    "user": {
      "id": 0,
      "accountId": 0,
      "fullName": "string",
      "firstName": "string",
      "lastName": "string",
      "username": "string",
      "email": "string",
      "accountName": "string",
      "profile": "string"
    },
    "state": "ACTIVE",
    "status": "UNREAD"
  }
]

Responses

Status	Meaning	Description	Schema
200	OK	OK	ResponseListNotificationDto

Example Responses

{
  "code": "UPDATED",
  "errors": {
    "all": [
      {
        "type": "GENERIC",
        "errorMessage": "string",
        "source": {},
        "field": "string",
        "errorKey": "string"
      }
    ]
  },
  "object": [
    {
      "id": 0,
      "subscribeMessage": {
        "id": 0,
        "targetId": "string",
        "targetType": "string",
        "topicApplication": "NFS",
        "topicName": "string",
        "topicPriority": "HIGH",
        "topicEnCaption": "string",
        "topicFrCaption": "string",
        "username": "string",
        "action": "SUBSCRIBE",
        "captionKey": "string",
        "en_message": "string",
        "fr_message": "string",
        "url": "string",
        "parameters": [
          {
            "name": "string",
            "dataType": "NUMBER",
            "value": "string"
          }
        ],
        "onlyAfterNow": true,
        "startTime": "2019-08-24T14:15:22Z",
        "cronExpression": "string",
        "endTime": "2019-08-24T14:15:22Z",
        "content": "string"
      },
      "unsubscribeMessage": {
        "id": 0,
        "targetId": "string",
        "targetType": "string",
        "topicApplication": "NFS",
        "topicName": "string",
        "topicPriority": "HIGH",
        "topicEnCaption": "string",
        "topicFrCaption": "string",
        "username": "string",
        "action": "SUBSCRIBE"
      },
      "scheduledTime": "2019-08-24T14:15:22Z",
      "user": {
        "id": 0,
        "accountId": 0,
        "fullName": "string",
        "firstName": "string",
        "lastName": "string",
        "username": "string",
        "email": "string",
        "accountName": "string",
        "profile": "string"
      },
      "state": "ACTIVE",
      "status": "UNREAD"
    }
  ]
}

Notification - Search¶

HTTP Request

POST /api/v1/notification/search

📋 Description: Submits a request to search for notifications based on specified criteria, enabling users to efficiently manage and respond to relevant alerts within the system.

Parameters

Name	In	Type	Required	Description
page	query	integer	false	Zero-based page index (0..N)
size	query	integer	false	The size of the page to be returned
sort	query	array[string]	false	Sorting criteria in the format: property,(asc\|desc). Default sort order is ascending. Multiple sort criteria are supported.
body	body	NotificationExtendedDtoFilter	false	Request body containing the search criteria and filters for retrieving specific notification records based on user-defined parameters.

Default Values¶

Parameter	Default	Type
page	`0`	query
size	`100`	query
sort	`["createdAt,ASC"]`	query

Parameter Constraints¶

Parameter	Constraints
page	Min: 0
size	Min: 1

Body Parameters

{
  "idIn": [
    0
  ],
  "idEqual": 0,
  "idLike": "string",
  "createdAtGreaterThanOrEqual": "2019-08-24T14:15:22Z",
  "createdAtLessThanOrEqual": "2019-08-24T14:15:22Z",
  "createdByLike": "string",
  "createdByEqual": "string",
  "modifiedAtGreaterThanOrEqual": "2019-08-24T14:15:22Z",
  "modifiedAtLessThanOrEqual": "2019-08-24T14:15:22Z",
  "modifiedByLike": "string",
  "modifiedByEqual": "string",
  "scheduledTimeLessThan": "2019-08-24T14:15:22Z",
  "stateEqual": "ACTIVE",
  "statusEqual": "UNREAD",
  "usernameIn": [
    "string"
  ],
  "targetIdEqual": "string",
  "targetTypeEqual": "string",
  "applicationEqual": "NFS",
  "topicPriorityEqual": "HIGH",
  "topicNameEqual": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	OK	PageNotificationDto

Example Responses

{
  "totalElements": 0,
  "totalPages": 0,
  "pageable": {
    "paged": true,
    "unpaged": true,
    "pageNumber": 0,
    "pageSize": 0,
    "offset": 0,
    "sort": {
      "unsorted": true,
      "sorted": true,
      "empty": true
    }
  },
  "numberOfElements": 0,
  "size": 0,
  "content": [
    {
      "id": 0,
      "subscribeMessage": {
        "id": 0,
        "targetId": "string",
        "targetType": "string",
        "topicApplication": "NFS",
        "topicName": "string",
        "topicPriority": "HIGH",
        "topicEnCaption": "string",
        "topicFrCaption": "string",
        "username": "string",
        "action": "SUBSCRIBE",
        "captionKey": "string",
        "en_message": "string",
        "fr_message": "string",
        "url": "string",
        "parameters": [
          {
            "name": "string",
            "dataType": "NUMBER",
            "value": "string"
          }
        ],
        "onlyAfterNow": true,
        "startTime": "2019-08-24T14:15:22Z",
        "cronExpression": "string",
        "endTime": "2019-08-24T14:15:22Z",
        "content": "string"
      },
      "unsubscribeMessage": {
        "id": 0,
        "targetId": "string",
        "targetType": "string",
        "topicApplication": "NFS",
        "topicName": "string",
        "topicPriority": "HIGH",
        "topicEnCaption": "string",
        "topicFrCaption": "string",
        "username": "string",
        "action": "SUBSCRIBE"
      },
      "scheduledTime": "2019-08-24T14:15:22Z",
      "user": {
        "id": 0,
        "accountId": 0,
        "fullName": "string",
        "firstName": "string",
        "lastName": "string",
        "username": "string",
        "email": "string",
        "accountName": "string",
        "profile": "string"
      },
      "state": "ACTIVE",
      "status": "UNREAD"
    }
  ],
  "number": 0,
  "sort": {
    "unsorted": true,
    "sorted": true,
    "empty": true
  },
  "first": true,
  "last": true,
  "empty": true
}

Notification - Mark As Unread¶

HTTP Request

POST /api/v1/notification/markAsUnread

📋 Description: Marks specified notifications as unread, allowing users to manage their notification status effectively and prioritize their attention on important messages.

Parameters

Name	In	Type	Required	Description
body	body	array[integer]	true	Request body containing the notification ID and user details to mark specified notifications as unread for effective message management.

Body Parameters

[
  0
]

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline

Example Responses

[
  {
    "id": 0,
    "subscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE",
      "captionKey": "string",
      "en_message": "string",
      "fr_message": "string",
      "url": "string",
      "parameters": [
        {
          "name": "string",
          "dataType": "NUMBER",
          "value": "string"
        }
      ],
      "onlyAfterNow": true,
      "startTime": "2019-08-24T14:15:22Z",
      "cronExpression": "string",
      "endTime": "2019-08-24T14:15:22Z",
      "content": "string"
    },
    "unsubscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE"
    },
    "scheduledTime": "2019-08-24T14:15:22Z",
    "user": {
      "id": 0,
      "accountId": 0,
      "fullName": "string",
      "firstName": "string",
      "lastName": "string",
      "username": "string",
      "email": "string",
      "accountName": "string",
      "profile": "string"
    },
    "state": "ACTIVE",
    "status": "UNREAD"
  }
]

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
anonymous	[NotificationDto]	false	none	[Data transfer object representing a notification that conveys important updates or alerts to users, facilitating timely communication and enhancing user engagement within the application.]
» id	integer(int64)	false	none	Unique identifier for the resource
» subscribeMessage	NotificationSubscribeMessageDto	false	none	Data transfer object representing a subscription request for notifications, enabling users to receive timely updates and alerts relevant to their interests or activities within the platform.
»» id	integer(int64)	false	none	Unique identifier for the resource
»» targetId	string	true	none	Unique identifier for the target
»» targetType	string	true	none	Type of the target
»» topicApplication	string	true	none	Specifies the application topic for which notifications are being subscribed, enabling targeted communication within the system.
»» topicName	string	true	none	Name of the topic
»» topicPriority	string	true	none	Priority of the topic
»» topicEnCaption	string	false	none	Descriptive caption of the topic in English, used to provide clarity and context for notifications related to subscription messages.
»» topicFrCaption	string	false	none	Caption for the French version of the notification topic, used to enhance user engagement in multilingual communication.
»» username	string	true	none	Unique identifier for the user subscribing to notifications, ensuring personalized communication and engagement within the platform.
»» action	string	false	none	Specifies the type of action to be performed in the notification subscription process.
»» captionKey	string	false	none	Key used to retrieve the localized caption for notifications, ensuring effective communication with users in their preferred language.
»» en_message	string	false	none	Contains the English language message for the notification subscription, facilitating clear communication with users.
»» fr_message	string	false	none	Contains the message content for subscription notifications, facilitating effective communication between the system and users.
»» url	string	false	none	Specifies the endpoint URL to which notifications will be sent upon subscription.
»» parameters	[NotificationParameterDto]	false	none	An array of parameters that define the specific criteria for subscribing to notifications within the system.
»»» name	string	false	none	Name of the resource
»»» dataType	string	false	none	Type of the data
»»» value	string	false	none	Represents the specific value associated with a notification parameter, used to customize alerts and communications within the system.
»» onlyAfterNow	boolean	false	none	Indicates whether notifications should only be sent for events occurring after the current time, allowing users to manage their alert preferences effectively.
»» startTime	string(date-time)	false	none	Time of the start
»» cronExpression	string	false	none	Specifies the schedule for recurring notifications in a cron format, enabling precise timing for automated alerts.
»» endTime	string(date-time)	false	none	Time of the end
»» content	string	false	none	Contains the message content for the notification subscription, enabling effective communication with users.
» unsubscribeMessage	NotificationUnsubscribeMessageDto	false	none	Data transfer object representing a user’s request to unsubscribe from notifications, facilitating the management of user preferences and enhancing engagement strategies.
»» id	integer(int64)	false	none	Unique identifier for the resource
»» targetId	string	true	none	Unique identifier for the target
»» targetType	string	true	none	Type of the target
»» topicApplication	string	true	none	Specifies the application topic for which the user wishes to unsubscribe from notifications.
»» topicName	string	true	none	Name of the topic
»» topicPriority	string	true	none	Priority of the topic
»» topicEnCaption	string	false	none	Descriptive label for the topic in English associated with the notification unsubscribe message, facilitating clear communication with users.
»» topicFrCaption	string	false	none	Caption for the topic in French, used to provide localized content for notifications related to user subscriptions.
»» username	string	true	none	Unique identifier for the user opting to unsubscribe from notifications, ensuring accurate processing of subscription preferences.
»» action	string	false	none	Specifies the type of action to be taken in relation to the notification unsubscribe request.
» scheduledTime	string(date-time)	false	none	Time of the scheduled
» user	UserDto	false	none	Data transfer object representing a user profile, encapsulating essential attributes such as user identification, contact information, and role within the organization to facilitate user management and access control.
»» id	integer(int64)	false	none	Unique identifier for the resource
»» accountId	integer(int64)	false	none	Unique identifier for the account
»» fullName	string	false	none	Full name of the resource
»» firstName	string	false	none	Name of the first
»» lastName	string	false	none	Name of the last
»» username	string	true	none	Represents the unique username associated with a user account, essential for authentication and user identification within the system.
»» email	string	false	none	Email address of the user, used for communication and account verification purposes within the system.
»» accountName	string	false	none	Name of the account
»» profile	string	false	none	Represents the user’s profile information, providing essential details for personalized interactions within the application.
» state	string	false	none	Represents the current status of the notification, indicating its progress within the workflow.
» status	string	false	none	Status of the resource

Enumerated Values

Attribute	Value
action	SUBSCRIBE, UNSUBSCRIBE
dataType	CURRENCY, DATE, DATE_TIME, NUMBER, TEXT
state	ACTIVE, DECOMMISSIONED
status	READ, UNREAD
topicApplication	AP, FOS, NFS, SPB, SSB
topicPriority	HIGH, LOW, MEDIUM

Notification - Mark As Read¶

HTTP Request

POST /api/v1/notification/markAsRead

📋 Description: Marks specified notifications as read, enabling users to manage their notification status effectively and maintain an organized communication workflow.

Parameters

Name	In	Type	Required	Description
body	body	array[integer]	true	Request body containing the notification IDs to be marked as read, enabling users to manage their notification status effectively.

Body Parameters

[
  0
]

Responses

Status	Meaning	Description	Schema
200	OK	OK	Inline

Example Responses

[
  {
    "id": 0,
    "subscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE",
      "captionKey": "string",
      "en_message": "string",
      "fr_message": "string",
      "url": "string",
      "parameters": [
        {
          "name": "string",
          "dataType": "NUMBER",
          "value": "string"
        }
      ],
      "onlyAfterNow": true,
      "startTime": "2019-08-24T14:15:22Z",
      "cronExpression": "string",
      "endTime": "2019-08-24T14:15:22Z",
      "content": "string"
    },
    "unsubscribeMessage": {
      "id": 0,
      "targetId": "string",
      "targetType": "string",
      "topicApplication": "NFS",
      "topicName": "string",
      "topicPriority": "HIGH",
      "topicEnCaption": "string",
      "topicFrCaption": "string",
      "username": "string",
      "action": "SUBSCRIBE"
    },
    "scheduledTime": "2019-08-24T14:15:22Z",
    "user": {
      "id": 0,
      "accountId": 0,
      "fullName": "string",
      "firstName": "string",
      "lastName": "string",
      "username": "string",
      "email": "string",
      "accountName": "string",
      "profile": "string"
    },
    "state": "ACTIVE",
    "status": "UNREAD"
  }
]

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
anonymous	[NotificationDto]	false	none	[Data transfer object representing a notification that conveys important updates or alerts to users, facilitating timely communication and enhancing user engagement within the application.]
» id	integer(int64)	false	none	Unique identifier for the resource
» subscribeMessage	NotificationSubscribeMessageDto	false	none	Data transfer object representing a subscription request for notifications, enabling users to receive timely updates and alerts relevant to their interests or activities within the platform.
»» id	integer(int64)	false	none	Unique identifier for the resource
»» targetId	string	true	none	Unique identifier for the target
»» targetType	string	true	none	Type of the target
»» topicApplication	string	true	none	Specifies the application topic for which notifications are being subscribed, enabling targeted communication within the system.
»» topicName	string	true	none	Name of the topic
»» topicPriority	string	true	none	Priority of the topic
»» topicEnCaption	string	false	none	Descriptive caption of the topic in English, used to provide clarity and context for notifications related to subscription messages.
»» topicFrCaption	string	false	none	Caption for the French version of the notification topic, used to enhance user engagement in multilingual communication.
»» username	string	true	none	Unique identifier for the user subscribing to notifications, ensuring personalized communication and engagement within the platform.
»» action	string	false	none	Specifies the type of action to be performed in the notification subscription process.
»» captionKey	string	false	none	Key used to retrieve the localized caption for notifications, ensuring effective communication with users in their preferred language.
»» en_message	string	false	none	Contains the English language message for the notification subscription, facilitating clear communication with users.
»» fr_message	string	false	none	Contains the message content for subscription notifications, facilitating effective communication between the system and users.
»» url	string	false	none	Specifies the endpoint URL to which notifications will be sent upon subscription.
»» parameters	[NotificationParameterDto]	false	none	An array of parameters that define the specific criteria for subscribing to notifications within the system.
»»» name	string	false	none	Name of the resource
»»» dataType	string	false	none	Type of the data
»»» value	string	false	none	Represents the specific value associated with a notification parameter, used to customize alerts and communications within the system.
»» onlyAfterNow	boolean	false	none	Indicates whether notifications should only be sent for events occurring after the current time, allowing users to manage their alert preferences effectively.
»» startTime	string(date-time)	false	none	Time of the start
»» cronExpression	string	false	none	Specifies the schedule for recurring notifications in a cron format, enabling precise timing for automated alerts.
»» endTime	string(date-time)	false	none	Time of the end
»» content	string	false	none	Contains the message content for the notification subscription, enabling effective communication with users.
» unsubscribeMessage	NotificationUnsubscribeMessageDto	false	none	Data transfer object representing a user’s request to unsubscribe from notifications, facilitating the management of user preferences and enhancing engagement strategies.
»» id	integer(int64)	false	none	Unique identifier for the resource
»» targetId	string	true	none	Unique identifier for the target
»» targetType	string	true	none	Type of the target
»» topicApplication	string	true	none	Specifies the application topic for which the user wishes to unsubscribe from notifications.
»» topicName	string	true	none	Name of the topic
»» topicPriority	string	true	none	Priority of the topic
»» topicEnCaption	string	false	none	Descriptive label for the topic in English associated with the notification unsubscribe message, facilitating clear communication with users.
»» topicFrCaption	string	false	none	Caption for the topic in French, used to provide localized content for notifications related to user subscriptions.
»» username	string	true	none	Unique identifier for the user opting to unsubscribe from notifications, ensuring accurate processing of subscription preferences.
»» action	string	false	none	Specifies the type of action to be taken in relation to the notification unsubscribe request.
» scheduledTime	string(date-time)	false	none	Time of the scheduled
» user	UserDto	false	none	Data transfer object representing a user profile, encapsulating essential attributes such as user identification, contact information, and role within the organization to facilitate user management and access control.
»» id	integer(int64)	false	none	Unique identifier for the resource
»» accountId	integer(int64)	false	none	Unique identifier for the account
»» fullName	string	false	none	Full name of the resource
»» firstName	string	false	none	Name of the first
»» lastName	string	false	none	Name of the last
»» username	string	true	none	Represents the unique username associated with a user account, essential for authentication and user identification within the system.
»» email	string	false	none	Email address of the user, used for communication and account verification purposes within the system.
»» accountName	string	false	none	Name of the account
»» profile	string	false	none	Represents the user’s profile information, providing essential details for personalized interactions within the application.
» state	string	false	none	Represents the current status of the notification, indicating its progress within the workflow.
» status	string	false	none	Status of the resource

Enumerated Values

Attribute	Value
action	SUBSCRIBE, UNSUBSCRIBE
dataType	CURRENCY, DATE, DATE_TIME, NUMBER, TEXT
state	ACTIVE, DECOMMISSIONED
status	READ, UNREAD
topicApplication	AP, FOS, NFS, SPB, SSB
topicPriority	HIGH, LOW, MEDIUM

Notification - Find All¶

HTTP Request

GET /api/v1/notification

📋 Description: Fetches a list of notifications for the authenticated user, enabling timely awareness of important updates and alerts within the application.

Parameters

Name	In	Type	Required	Description
pageable	query	Pageable	true	Indicates whether the response should be paginated, allowing users to retrieve notifications in manageable segments for improved data handling and user experience.

Responses

Status	Meaning	Description	Schema
200	OK	OK	PageNotificationDto

Example Responses

{
  "totalElements": 0,
  "totalPages": 0,
  "pageable": {
    "paged": true,
    "unpaged": true,
    "pageNumber": 0,
    "pageSize": 0,
    "offset": 0,
    "sort": {
      "unsorted": true,
      "sorted": true,
      "empty": true
    }
  },
  "numberOfElements": 0,
  "size": 0,
  "content": [
    {
      "id": 0,
      "subscribeMessage": {
        "id": 0,
        "targetId": "string",
        "targetType": "string",
        "topicApplication": "NFS",
        "topicName": "string",
        "topicPriority": "HIGH",
        "topicEnCaption": "string",
        "topicFrCaption": "string",
        "username": "string",
        "action": "SUBSCRIBE",
        "captionKey": "string",
        "en_message": "string",
        "fr_message": "string",
        "url": "string",
        "parameters": [
          {
            "name": "string",
            "dataType": "NUMBER",
            "value": "string"
          }
        ],
        "onlyAfterNow": true,
        "startTime": "2019-08-24T14:15:22Z",
        "cronExpression": "string",
        "endTime": "2019-08-24T14:15:22Z",
        "content": "string"
      },
      "unsubscribeMessage": {
        "id": 0,
        "targetId": "string",
        "targetType": "string",
        "topicApplication": "NFS",
        "topicName": "string",
        "topicPriority": "HIGH",
        "topicEnCaption": "string",
        "topicFrCaption": "string",
        "username": "string",
        "action": "SUBSCRIBE"
      },
      "scheduledTime": "2019-08-24T14:15:22Z",
      "user": {
        "id": 0,
        "accountId": 0,
        "fullName": "string",
        "firstName": "string",
        "lastName": "string",
        "username": "string",
        "email": "string",
        "accountName": "string",
        "profile": "string"
      },
      "state": "ACTIVE",
      "status": "UNREAD"
    }
  ],
  "number": 0,
  "sort": {
    "unsorted": true,
    "sorted": true,
    "empty": true
  },
  "first": true,
  "last": true,
  "empty": true
}