# Retrieve Supported Patches

Retrieves the list of all patches supported and manageable by Endpoint Central.

**This API endpoint is deprecating soon**

## Endpoint

`GET /api/1.4/patch/supportedpatches`

## Request

### Request URL

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

### Scope

`DesktopCentralCloud.PatchMgmt.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Query Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| **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 |  |
| **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 |
| **platformfilter** | string | Optional | Windows/Mac/Linux |
| **approvalstatusfilter** | integer | Optional | 211: Approved — patch has been approved for deployment, 0: Not Approved — patch approval is pending, 212: Declined — patch has been declined |
| **languagefilter** | integer | Optional |  |

### Sample Request

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

## Response

### HTTP 200

Response Body: `application/json`

| Field | Type | Description |
|---|---|---|
| **Links** | JSON Object | Pagination links for next and previous pages |
| **messageResponse** | JSON Array | Array of supported patch 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 |

### Sample Response: HTTP 200

Paginated list of all supported patches

```json
{
  "response_code": 200,
  "message_type": "supportedpatches",
  "message_response": {
    "total": 21776,
    "limit": 25,
    "page": 1,
    "supportedpatches": [
      {
        "severity": 1,
        "patch_id": 309239,
        "patch_name": "BANDIZIP-SETUP.EXE",
        "patch_description": "Bandizip (6.22.0.0)",
        "vendor_name": "Bandisoft",
        "superceded_by": "NA",
        "bulletin_id": "TU-075",
        "update_name": "Third Party Updates",
        "patch_noreboot": 1,
        "patch_released_time": 1552974574000,
        "patch_supported_time": 1552974574000,
        "patch_size": 6537016,
        "patch_uninstall_status": 0,
        "platform_name": "Windows",
        "download_status": 221,
        "patch_type": 2,
        "pmseverity.name": "Low",
        "patch_status": 211
      }
    ]
  },
  "message_version": "1.0",
  "status": "success"
}
```

## Rate Limits

![](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.