List Assets API

POST/etm/api/rest/v1/assets/list

Use this API to get a list of assets. You can filter the list using QQL queries at the asset level and, optionally, at the finding level within an asset context.

Input ParametersInput Parameters

Parameter	Mandatory/Optional	Data Type	Description
pageNumber	Optional	Integer	The page is to be returned. Starts from zero. Default: 0
pageSize	Optional	Integer	Provide the number of records per page to be included in the response. Default: 20
query	Optional	String	Provide QQL query. For example, `asset.criticalityScore:5`
havingQuery	Optional	String	Provide a secondary query applied at the finding level within an asset context.
searchContext	Optional	Enum	Provide query parsing context. Use ASSET for this endpoint. Default: Asset
filters	Optional	Map	Filter the list by providing a query.
includeNonReconciled	Optional	Boolean	Include unreconciled findings across scanners when set to true.
Authorization	Mandatory	String	Authorization token to authenticate to the Qualys Enterprise TruRisk Platform Prepend token with Bearer and one space. For example - Bearer authToken

SampleSample

API Request

curl -X POST
'<qualys_base_url>/etm/api/rest/v1/assets/list'
--header 'Content-Type: application/json'
--header 'Authorization: Bearer <JWT Token>'
--data '{
    "pageNumber": 0,
    "pageSize": 2,
    "query": "asset.criticalityScore:3",
    "havingQuery": "finding.severity:4"
}'

Response

{
  "data": [
    {
      "name": "10.xxx.xxx.xxx",
      "criticalityScore": 4,
      "truRiskScore": 194,
      "host": {
        "os": {
          "category2": "Unidentified",
          "product": "Unidentified",
          "category1": "Unidentified",
          "name": "Unidentified",
          "category": "Unidentified / Unidentified"
        }
      },
      "inventory": [
        {
          "source": "IP Scanner",
          "firstSeen": "2026-03-04T05:27:36.000Z",
          "lastSeen": "2026-06-17T01:12:39.000Z"
        }
      ],
      "assetType": "HOST",
      "tags": [
        {
          "name": "Loreal_WZON_AM_IT"
        },
        {
          "name": "India Targets - TruConfirm",
          "criticalityScore": 3
        },
        {
          "name": "RX Version",
          "criticalityScore": 3
        },
        {
          "name": "TestJ000000"
        },
        {
          "name": "CAUintManager_BU"
        },
        {
          "name": "AG1",
          "criticalityScore": 4
        },
        {
          "name": "India Targets",
          "criticalityScore": 3
        },
        {
          "name": "India Targets - TruConfrim",
          "criticalityScore": 3
        },
        {
          "name": "DEV:  CS:  TYPE:  SERVER"
        },
        {
          "name": "Firewall Detected"
        }
      ]
    }
  ],
  "totalCount": 30,
  "searchAfter": [
    1782649659000
  ]
}

Last updated: July, 2026