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

## Endpoints

`GET /api/1.4/patch/summary`

## Request URL

`https://{serverurl}/api/1.4/patch/summary`

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

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

## Sample Request

### Curl

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

- `JSON Object`
  - **message_type** `string`: Value: summary
  - **message_version** `string`: API version: 1.0
  - **status** `string`: Operation status: success
  - **response_code** `string`: Response code: 200

## Possible Response Codes

- **200** `HTTP code`

## 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"
}
```

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