Get Patches Tab Report

User this API to get a Patches tab report that matches the filters provided for Windows and Linux platforms.

Note: The API rate limit is 10 requests per hour per customer.

GET/pm/v1/report/patch

Input ParametersInput Parameters

Parameter	Mandatory/Optional	Data Type	Description
havingQuery	Optional	string	Specify a QQL to filter patches based on asset search criteria. For example, name: windowsasset1
query	Optional	string	Specify a QQL to filter patches based on search criteria. For example, isSecurity:true Append the QQL (patchStatus:[Missing,Installed] and isSuperseded:false) to filter the latest missing and installed patches.
sort	Optional	string	Sort the patch values by certain data. For example, [{"vendorSeverity":"asc"}]

Parameter

Mandatory/Optional

Data Type

Description

havingQuery

Optional

string

Specify a QQL to filter patches based on asset search criteria.

For example, name: windowsasset1

query

Optional

string

Specify a QQL to filter patches based on search criteria.

For example, isSecurity:true Append the QQL (patchStatus:[Missing,Installed] and isSuperseded:false) to filter the latest missing and installed patches.

sort

Optional

string

Sort the patch values by certain data.

For example, [{"vendorSeverity":"asc"}]

Sample - Get Patches tab reportSample - Get Patches tab report

API request

    
        curl -X GET 
        "https://<QualysBaseURL>/pm/v1/report/patch?havingQuery=tags.name%3A%20%60Cloud%20Agent%60&platform=Windows&query=rebootRequired%3A%20true%20and%20%28patchStatus%3A%20%5BMissing%2C%20Installed%5D%20and%20isSuperseded%3A%20false%29&sort=%5B%7B%22vendorSeverity%22%3A%22asc%22%7D%5D" -H "accept: application/json" -H "Authorization: Bearer <<jwt token>>"

Response

    
        {
    "reportId": "ba7fa6f8-a5cd-40ed-85ce-eacb4191abef"
}