# Retrieve Patch Report for a System

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

**This API endpoint is deprecating soon**

## Endpoint

`GET /api/1.4/patch/systemreport`

## Request

### Request URL

`https://{server-hostname}:8383/api/1.4/patch/systemreport`

### Scope

`PatchMgmt.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/api/1.4/patch/systemreport \
  --header 'Authorization:  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 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.