Release 2.13 API

September 02, 2024

Before understanding the API release highlights, learn more about the API server URL to be used in your API requests by referring to the Know Your Qualys API Server URL section. For this API Release Notes, <qualys_base_url> is mentioned in the sample API requests.

What's New?

New API - Get a List of More than Ten Thousand Patches

New or Updated API	New
API Endpoint	/pm/v2/patches
Method	POST
DTD or XSD changes	Not Applicable

We have introduced a new API: Get a List of More than Ten Thousand Patches. You can use this API to get a list of more than ten thousand patches in a paginated format.

Input Parameters

Sample - Get a List of All patches (using searchAfter parameter)

API Request

curl -X 'POST' \
'<qualys_base_url>/pm/v2/patches?platform=Windows' \
-H 'accept: application/json' \
-H 'searchAfter: 1663200000000,3fde1ad4-d243-369f-be18-981b1a17b89c ' \
-H 'Authorization: Bearer <Bearer_Token>' \
-H 'Content-Type: application/json' \
-d '{
"query": "appFamily:`Windows` and category:`Security Patches`",
"havingQuery": "operatingSystem:Windows",
"attributes": "modifiedDate,title,id"
}'

API Response

[
{
"modifiedDate": 1663200000000,
"title": "April 12, 2022-KB5012117 Cumulative Update for .NET Framework 3.5 and 4.8 for Windows 10, version 20H2, Windows Server, version 20H2, Windows 10 Version 21H1, and Windows 10 Version 21H2",
"id": "5537be54-b339-3d19-93cb-2db1e3284d1a"
},
...
{
"modifiedDate": 1627344000000,
"title": "Security Cumulative Update for Windows 10 Version 2004 and 20H2: May 11, 2021 (KB5003173)",
"id": "08245348-00fc-3bad-82af-fc5b6f505a05"
}
]

Sample - Get a List of Patches (using pageSize and searchAfter parameters)