Get a List of Patches for a Specific Customer

Use this API to get patches for a given customer after applying the specified filter.

GET/pm/v1/patches

Input ParametersInput Parameters

Parameter

Mandatory/Optional

Data Type

Description

havingQuery

Optional

string

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

For example, status:Enabled

pageNumber

Optional

string

The page to be returned.

Default value: 0

pageSize

Optional

string

Limit number of rows to be returned per page.

Default value: 10

platform

Optional

string

The platform type.

- Available values: Linux, Windows

- Default value: Windows

query

Optional

string

Specify a QQL to filter patches based on patch catalog search criteria.

For example, appFamily:Firefox

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

sort

Optional

string

Sort the patch values by certain data.

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

Sample - Get a list of patches for Windows Platform sorted by Vendor SeveritySample - Get a list of patches for Windows Platform sorted by Vendor Severity

API request

curl -X 'GET' \   '<qualys_base_url>/pm/v1/patches?platform=Windows&query=patch.id%3A%2024e57a0f-e4bf-3041-90fc-52590b6876e7&sort=%5B%7B%22vendorSeverity%22%3A%22asc%22%7D%5D%27 \
-H 'accept: application/json' \
-H 'Authorization: : <JWT_TOken>

Response

   [
  {
    "architecture": [
      "X64"
    ],
    "bulletin": "MSNS18-02-QP81",
    "category": "Non-Security Patches",
    "cve": [],
    "kb": "KB4075212",
    "modifiedDate": 1521763200000,
    "appFamily": [
      "Windows"
    ],
    "product": [
      "Windows 8.1 Enterprise (x64)",
      "Windows Embedded 8.1 Industry Pro (x64)",
      "Windows 8.1 (x64)",
      "Windows Embedded 8.1 Industry Enterprise (x64)",
      "Windows 8.1 Pro with Media Center (x64)",
      "Windows 8.1 Pro (x64)"
    ],
    "publishedDate": 1519257600000,
    "qid": [],
    "rebootRequired": true,
    "supersededBy": [
      "93302315-4213-3517-89da-a101ce0c81ea",
      "234f5e28-8b23-30b5-b2cc-a2a81bab2710",
      "98f90c37-4dce-3178-bb21-606c062058db",
      ...
      ....
      "a5678b9c-efdb-36a9-9aef-3a49b5b0e01a",
      "692b8e94-76f3-34c7-a3d0-33b2ff0b565f",
      "f587fff3-eca5-38f1-92ff-57dcd7e99167",
      "d613769b-5887-3d6d-b813-27ada30e91c4",
      "ceaf795e-4b19-3b4e-b5c8-382718c92dca",
      "de50db20-d560-32e1-a779-3a3d87cb4d45"
    ],
    "supersedes": [
      "1262a6b1-9b2a-3eb0-a9d6-debfa309b84e",
      "cbb9f073-da1b-37ab-9cfd-2a49d519f0e9",
      "c0a2cacc-17ef-3b5c-8ca2-d3b5c5af04a0",
      "498e63bc-c827-3e23-a922-e1cb94ee7ca0",
      "5b902724-6f4d-3236-9085-9780e7e6d5be",
      "1c7d0305-8ef1-350d-b490-be211df1923b",
      "87293b97-2892-35c3-a6d9-53551603fc1f",
      "dd22de5c-a19f-38c5-8f9f-44cefc0eb78d",
      "ba1ccb5a-9c93-3af0-8b76-7895d29d6bd7",
      "06c31f20-edf6-3166-90a4-0f45035bcda4"
    ],
    "title": "Preview of Monthly Quality Rollup for Windows 8.1 and Windows Server 2012 R2: February 22, 2018",
    "type": "OS",
    "vendor": "Microsoft",
    "vendorSeverity": "None",
    "vendorlink": "http://support.microsoft.com/kb/4075212",
    "missingCount": 0,
    "installedCount": 0,
    "downloadMethod": "Automatic",
    "advisory": null,
    "enabled": true,
    "packageDetails": null,
    "reliability": null,
    "isFeatureUpdate": false,
    "isEsuPatch": false,
    "esuOsVersion": null,
    "qualysPublishedDate": 1519257600000,
    ""qualysUpdatedDate": 1783053451311,"
    "id": "24e57a0f-e4bf-3041-90fc-52590b6876e7",
    "isSecurity": false,
    "isSuperseded": true,
    "isRollback": true,
    "isCustomizedDownloadUrl": false
  }
]