# Get All Patches

Provides a complete list of patches applicable to systems, including their status, severity, and other details.

**This API endpoint is deprecating soon**

## Endpoints

[GET /api/1.4/patch/allpatches](https://www.manageengine.com/products/desktop-central/help/api/cloud/patch-legacy-get-all-patches.html)

## Request URL

`https://`[*{serverurl}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/api/1.4/patch/allpatches`

### Scope

`DesktopCentralCloud.PatchMgmt.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Query Parameters

- **patchid** `string` *(Optional)*: Filter for patch with a particular id
- **bulletinid** `string` *(Optional)*
- **severityfilter** `integer` *(Optional)*: 0: Unrated — no severity assigned, 1: Low — minimal impact, 2: Moderate — average impact, 3: Important — significant impact, 4: Critical — high impact or security risk
- **patchstatusfilter** `integer` *(Optional)*: 201: Installed — patch is already installed, 202: Missing — patch is not installed
- **domainfilter** `string` *(Optional)*: Get domain list from api/1.4/desktop/serverproperties
- **platformfilter** `string` *(Optional)*: Windows/Mac/Linux
- **branchofficefilter** `string` *(Optional)*: Get branch office list from api/1.4/desktop/serverproperties
- **customgroupfilter** `string` *(Optional)*: Get Custom Group list from api/1.4/desktop/serverproperties
- **searchvalue** `string` *(Optional)*
- **searchcolumn** `string` *(Optional)*
- **searchtype** `string` *(Optional)*
- **sortorder** `string` *(Optional)*
- **orderby** `string` *(Optional)*
- **pagelimit** `string` *(Optional)*: Number of records per page.
- **page** `integer` *(Optional)*: Current page number for pagination.
- **customerid** `long` *(Optional)*
- **approvalstatusfilter** `integer` *(Optional)*: 211: Approved — patch has been approved for deployment, 0: Not Approved — patch approval is pending, 212: Declined — patch has been declined

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/api/1.4/patch/allpatches \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body — application/json

- `JSON Object`
  - **Links** `JSON Object`: Pagination links for next and previous pages
  - **messageResponse** `JSON Array`: Array of patch-system mapping entries
  - **metadata** `JSON Object`: Pagination metadata
  - **status** `string`: Operation result: success
  - **totalPages** `string`: Total number of pages available
  - **totalRecords** `string`: Total number of records matching the query

## Possible Response Codes

- **200** `HTTP code`

## Sample Response: HTTP 200

Paginated list of all applicable patches

```json
{
  "response_code": 200,
  "message_type": "allpatches",
  "message_response": {
    "total": 4094,
    "allpatches": [
      {
        "severity": 1,
        "installed": 2,
        "patch_id": 309232,
        "vendor_name": "Tim Kosse",
        "superceded_by": "NA",
        "failed": 2,
        "bulletin_id": "TU-058",
        "update_name": "Third Party Updates",
        "patch_noreboot": 1,
        "patch_released_time": 1552971857000,
        "patch_size": 7917152,
        "patch_uninstall_status": 1,
        "platform_name": "Windows",
        "missing": 5,
        "download_status": 221,
        "patch_type": 2,
        "pmseverity.name": "Low",
        "patch_status": 211
      }
    ],
    "limit": 25,
    "page": 1
  },
  "message_version": "1.0",
  "status": "success"
}
```

![ ](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.