Get Assets Report
Click to view navigation pane


Get Assets Tab Report

Use this API to generate the asset tab report for the Windows and Linux 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"}]

platform

Optional

string

Specify the platform to download the report. The supported options are Windows and Linux.

Sample - Get the asset tab report with specified filters. (Example: Report generation for the Windows platform)Sample - Get the asset tab report with specified filters. (Example: Report generation for the Windows platform)

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"
}