notification

6 min

In the Patch Management feature of Ivanti Neurons, the grid on the Patch Intelligence homepage contains a list of all notifications that apply to your organization. A notification can be a security update that describes a particular software vulnerability and the patches that address the vulnerability. Notifications often relate to one or more CVEs.

The notification endpoint enables you to retrieve the set of data items that represents a notification result, such as a security bulletin.

HTTP Method

GET

Request URI

https://<hostname>/api/patch/content/v1/notification

Required Header Parameters

Name	Type	Description
Authorization	Authheader	Use the Bearer <access-token> value determined during the Authenticate to the Patch Management API process.

Optional Parameters

Name	Type	Description
Filter	String	An optional filter statement. The default is HasSupersededPatches eq false.
OrderBy	String	If no sort value is provided, results are sorted by PublishedDate in descending order.
PageNumber	Number	The requested page number of the data result. If no value is provided, the default value is 1.
PageSize	Number	The requested page size of the data result. The maximum page size is 150. If no value is provided, the default value is 10.

Example Response

{
  "pageCount": 0,
  "currentPage": 0,
  "totalRecords": 0,
  "data": [
    {
      "affectedDevicesCount": 0,
      "cveCount": 0,
      "cves": [
        "string"
      ],
      "cvesExploited": [
        "string"
      ],
      "hasSupersededPatches": true,
      "name": "string",
      "notificationId": "string",
      "operatingSystem": "Any",
      "overallReliability": {
        "successfulInstalls": 0,
        "failedInstalls": 0
      },
      "products": [
        "string"
      ],
      "releasedDate": "2025-02-13T16:46:12.801Z",
      "reliability": 0,
      "summary": "string",
      "title": "string",
      "tenantReliabilityScore": 0,
      "threat": 0,
      "threatCvss": 0,
      "threatV2": 0,
      "threatV2Exploited": true,
      "trendingScore": 0,
      "updatedDate": "2025-02-13T16:46:12.801Z",
      "vendorLink": "string",
      "vendorName": "string"
    }
  ]

Output Data Properties

The following set of data items represent a notification result that will be returned as part of a successful notification_get response.

Name	Type	Format	Description
affectedDevicesCount	Integer	Int32	The number of devices affected by the notification.
cveCount	Integer	Int32	The number of CVEs associated with the Advisory.
cves	Array of strings		The collection of CVEs associated with the Advisory. The Cve endpoint can be used to query for the list of CVEs addressed in the notification.
cvesExploited	Array of strings		The collection of exploited CVEs. The Cve endpoint can be used to query for the list of exploited CVEs addressed in the notification.
hasSupersededPatches	Boolean		Specifies if the notification has superseded patches.
name	String		The name of the notification. The name is usually shorter and less descriptive than the title.
notificationId	String		The ID of the notification.
operatingSystem	String		The name of the operating system.
overallReliabilty	Integer	Int64	This complex field is not filterable or sortable. The number of successful and failed installations.
products	Array of strings		The list of products.
releasedDate	String	Date-time	The date the notification was originally released.
reliability	Number	Double	The reliability score.
summary	String		The summary of the notification.
tenantReliabilityScore	Number	Double	The tenant reliability score.
threat	Number	Float	The threat score.
threatCvss	Number	Float	The threat CVSS score.
threatV2	Number	Float	The threat V2 score.
threatV2Exploited	Boolean		Specifies if the threat is exploited.
title	String		The notification title. This is the descriptive title that describes the threat addressed by the notification.
trendingScore	Integer	Int32	The trending score.
updatedDate	String	Date-time	The date the security Advisory was last updated.
vendorLink	String		The vendor URL link.
vendorName	String		The name of the vendor that issued the notification.

Default Filter and Sort Behavior

The API will not return all records. If no filter and sort criteria are provided, this endpoint returns all notification data from the last 60 days based on released date.

Neurons API