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 ParametersInput Parameters
|
Parameter |
Mandatory/Optional |
Data Type |
Description |
|
searchAfter |
Optional |
String |
Provide this input parameter, which is a combination of modifiedDate and patchID. For Example: 1654181062470,00000000-0000-0000-0000-000000000001. |
|
pageSize |
Optional |
String |
Enter the value to limit the number of records to be returned per page. |
|
platform |
Optional |
String |
Specify the platform type. The supported values are Windows and Linux. |
Sample - Get a List of All patches (using searchAfter parameter)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)Sample - Get a List of Patches (using pageSize and searchAfter parameters)
API Request
curl -X 'POST' \
'<qualys_base_url>/pm/v2/patches?pageSize=2&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": 1663200000000,
"title": "May 10, 2022-KB5013624 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": "815d5072-298b-3b3a-af9b-2b349431bc50"
}
]