Endpoint: notification

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.

Required Header Parameters

Name Type Description

Authorization

Authheader

Use the Bearer <access-token> value determined during the Authenticate to the Patch Management API process.

X-RapidAPI-Key

Enum

The key that applications and developers need to invoke the API.

X-RapidAPI-Host

String

The name that identifies which API will be used. For example: my-api-name.ivanti.rapidapi.com.

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.

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 bulletin.
cves Array of strings   The collection of CVEs associated with the bulletin. 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 bulletin 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.