# Retrieve Supported Patches

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

**This API endpoint is deprecating soon**

## Endpoints

`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

- **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

### 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 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

### Possible Response Codes

- **200** `HTTP code`

### 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 Limit

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