# Retrieve Patch Details Summary (Deprecating soon)

Provides various summaries related to the patch module including health status, scan summary, and other key metrics.

**This API endpoint is deprecating soon**

## Endpoint

`GET /api/1.4/patch/summary`

## Request URL

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

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

## Sample Request

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

## Response Parameters

### HTTP Code 200

#### Response Body — application/json

| Attribute | Type | Description |
|---|---|---|
| Root object | JSON Object |  |
| `message_type` | string | Value: summary |
| `message_response` | JSON Object | Patch module summary data |
| `message_version` | string | API version: 1.0 |
| `status` | string | Operation status: success |
| `response_code` | string | Response code: 200 |

### Sample Response: HTTP 200

Complete patch module summary

```json
{
  "response_code": 200,
  "message_type": "summary",
  "message_response": {
    "summary": {
      "patch_summary": {
        "installed_patches": 2307,
        "applicable_patches": 3921,
        "new_patches": 369,
        "missing_patches": 1614
      },
      "missing_patch_severity_summary": {
        "moderate_count": 68,
        "unrated_count": 589,
        "total_count": 1614,
        "critical_count": 293,
        "important_count": 568,
        "low_count": 96
      },
      "apd_summary": {
        "last_task_scheduled_time": null,
        "next_task_scheduled_time": null,
        "number_of_apd_tasks": 33,
        "last_executed_task": null,
        "next_task": null
      },
      "system_summary": {
        "total_systems": 97,
        "moderately_vulnerable_systems": 0,
        "healthy_systems": 35,
        "highly_vulnerable_systems": 61,
        "health_unknown_systems": 1
      },
      "patch_scan_summary": {
        "unscanned_system_count": 2,
        "scanned_systems": 95,
        "scan_success_count": 37,
        "scan_failure_count": 58
      },
      "vulnerability_db_summary": {
        "last_db_update_status": "Success",
        "next_db_update_scheduled_time": 1553058600000,
        "is_auto_db_update_disabled": false,
        "last_db_update_time": 0,
        "db_update_in_progress": "false"
      }
    }
  },
  "message_version": "1.0",
  "status": "success"
}
```

## Rate Limit

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