Get Assets Tab Report

Use this API to generate the asset tab report for the assets that match the filters requested in the input.

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

GET/pm/v1/report/asset

Input ParametersInput Parameters

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

Parameter

Mandatory/Optional

Data Type

Description

havingQuery

Optional

string

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

For example, category:"Security Patches"

query

Optional

string

Specify a QQL to filter assets based on search criteria.

For example, name:'Asset-windowsmachine1'

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

sort

Optional

string

Sort the asset values by certain data.

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

Sample - Get the asset tab report with specified filtersSample - Get the asset tab report with specified filters

API request

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

Response

    
        {
    "reportId": "fdeff786-7c63-42fc-b64f-60560671df06"
}