# Retrieve Patch Report for a System (Deprecating soon)

Retrieves the list of patches and their status for a specific computer managed by.

**This API endpoint is deprecating soon**

## Endpoints

`GET /api/1.4/patch/systemreport`

## Request URL

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

## 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)*
- **resid** `string` *(Optional)*: Filter for system with a resource id
- **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
- **patchstatusfilter** `integer` *(Optional)*: 201: Installed — patch is already installed, 202: Missing — patch is not installed
- **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)*
- **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)*
- **taskid** `long` *(Optional)*

## Sample Request

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

## Response Parameters

### HTTP Code 200

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

- `JSON Object`
  - **message_type** `string`: Value: systemreport
  - **message_response** `JSON Object`: Paginated system patch report data
  - **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

Paginated list of patches for a specific system

```json
{
  "response_code": 200,
  "message_type": "systemreport",
  "message_response": {
    "total": 64,
    "systemreport": [
      {
        "severity": 4,
        "affected_patch_status": 201,
        "patch_id": 9110,
        "patch_name": "office2007-kb2288621-fullfile-x86-glb.exe",
        "patch_description": "Security Update for the 2007 Microsoft Office System (KB2288621)",
        "vendor_name": "Microsoft",
        "deployment_status": 209,
        "superceded_by": "NA",
        "severity_name": "dc.common.CRITICAL",
        "bulletin_id": "MS10-063",
        "update_name": "Security Updates",
        "patch_noreboot": 0,
        "patch_released_time": 1284402600000,
        "affectedpatchstatusdefn.label": "dc.common.INSTALLED",
        "patch_uninstall_status": 1,
        "platform_name": "Windows",
        "download_status": 221,
        "patch_type": 0,
        "installed_time": 1544818523000,
        "pmseverity.name": "Critical",
        "patch_status": 211
      }
    ],
    "limit": 25,
    "page": 1
  },
  "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.