# Retrieve Specified Patch Details

Retrieves detailed audit-level information about a specific patch installation status across all applicable systems.

**This API endpoint is deprecating soon**

## Endpoint

`GET /api/1.4/patch/patchdetails`

## Request URL

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

## 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
- **resid** `string` — Optional
- **domainfilter** `string` — Optional
  - Get domain list from `api/1.4/desktop/serverproperties`
- **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`
- **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
- **languagefilter** `integer` — Optional
- **patchtypefilter** `integer` — Optional
  - `0`: Security Updates
  - `1`: Critical Updates
  - `2`: Third-Party Updates
  - `3`: Updates
  - `4`: Definition Updates
  - `5`: Service Packs
  - `6`: Feature Packs
  - `7`: Rollups
  - `8`: Tools
  - `9`: Driver
  - `10`: Optional Updates
  - `11`: Preview Rollups
  - `12`: BIOS
- **deploymentstatusfilter** `integer` — Optional
- **platformfilter** `string` — Optional
  - Windows/Mac/Linux

## Sample Request

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

## Response Parameters

### HTTP Code 200

#### Response Body: `application/json`

- `JSON Object`
  - **message_type** `string`
    - Value: `patchdetails`
  - **message_response** `JSON Object`
    - Paginated patch-level audit data per system
  - **message_version** `string`
    - API version: `1.0`
  - **status** `string`
    - Operation status: `success`
  - **response_code** `string`
    - Response code: `200`

## Sample Response: HTTP 200

Patch details with system-level status

```json
{
  "response_code": 200,
  "message_type": "patchdetails",
  "message_response": {
    "total": 5,
    "limit": 25,
    "patchdetails": [
      {
        "severity": 3,
        "patch_id": 23956,
        "resource.name": "COMPUTER-01",
        "patch_name": "SQLPreReqHandler_KB4057116_x64.exe",
        "patch_description": "Security update for SQL Server 2012 SP4 x64 (KB4057116)",
        "vendor_name": "Microsoft",
        "superceded_by": "NA",
        "ip_address": "172.24.143.191",
        "bulletin_id": "MS18-JAN9",
        "update_name": "Security Updates",
        "patch_released_time": 1515715200000,
        "patch_size": 0,
        "resource.domain_netbios_name": "DOMAIN",
        "service_pack": "Windows Server 2012 R2 Gold (x64)",
        "resource_id": 50924,
        "os_name": "Windows Server 2012 R2 Standard Edition (x64)",
        "pmseverity.name": "Important"
      }
    ],
    "page": 1
  },
  "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.