# Fetch System Report for All Vulnerable Resources

Retrieves a list of computers along with associated details on vulnerabilities, misconfigurations, and patch information.

## Endpoints

`GET /dcapi/threats/systemreport`

## Request URL

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

## Scope

`DesktopCentralCloud.VulnerabilityMgmt.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Query Parameters

- **page** `string` *(Optional)*

  Displays the content of the provided page number.

- **customername** `string` *(Optional)*

- **customerid** `long` *(Optional)*

- **pageLimit** `string` *(Optional)*

  Displays the provided number of computers per page.

- **resource_id** `string` *(Optional)*

  Filters systems based on the resource ID provided.

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/threats/systemreport \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body — application/json

`JSON Object`

## Possible Response Codes

- **200** `HTTP code`

## Sample Response: HTTP 200

```json
{
  "metadata": {
    "pageLimit": 30,
    "totalRecords": "1",
    "totalPages": 1,
    "links": {
      "next": null,
      "prev": null
    },
    "page": 1
  },
  "response_code": 200,
  "message_type": "systemreport",
  "message_response": {
    "systemreport": [
      {
        "servermisconfigurations": [
          {
            "updatedtime": "1704451505960",
            "hardening_status": "open",
            "filepath": "C:\\Program Files\\ManageEngine\\PatchConnectPlus",
            "hardeningid": "55"
          },
          {
            "updatedtime": "1704451505960",
            "hardening_status": "open",
            "filepath": "C:\\Program Files\\ManageEngine\\PatchConnectPlus",
            "hardeningid": "111"
          }
        ],
        "systemmisconfigurations": [
          {
            "updated_time": "1704451505976",
            "misconfig_status": "open",
            "misconfigid": "6",
            "global_gpo": "not applied"
          },
          {
            "updated_time": "1704451505976",
            "misconfig_status": "open",
            "misconfigid": "7",
            "global_gpo": "not applied"
          }
        ],
        "patches": [
          {
            "severity": "Important",
            "patchname": "vcredist_x86_sp1.exe",
            "updated_time": "1704363395117",
            "update_type": "Security Updates",
            "patch_description": "Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package MFC Security Update",
            "kb_number": "2565063",
            "vendor_name": "Microsoft",
            "installed_system_count": 1,
            "supercededby": "NA",
            "patch_released_time": "1307989800000",
            "patch_supported_time": "1307989800000",
            "patch_size": "8993744",
            "patchid": "12621",
            "patch_uninstall": "not supported",
            "bulletinid": "MS11-025",
            "approveduser_first_name": "DC-SYSTEM-USER",
            "reboot_required": "may require",
            "platform_name": "Windows",
            "download_status": "--",
            "missing_system_count": 0,
            "failed_system_count": 0,
            "patch_status": "approved"
          },
          {
            "severity": "Important",
            "patchname": "vcredist_x64_sp1.exe",
            "updated_time": "1704363395117",
            "update_type": "Security Updates",
            "patch_description": "Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package MFC Security Update",
            "kb_number": "2565063",
            "vendor_name": "Microsoft",
            "installed_system_count": 1,
            "supercededby": "NA",
            "patch_released_time": "1307989800000",
            "patch_supported_time": "1307989800000",
            "patch_size": "10274136",
            "patchid": "12622",
            "patch_uninstall": "not supported",
            "bulletinid": "MS11-025",
            "approveduser_first_name": "DC-SYSTEM-USER",
            "reboot_required": "may require",
            "platform_name": "Windows",
            "download_status": "--",
            "missing_system_count": 0,
            "failed_system_count": 0,
            "patch_status": "approved"
          }
        ],
        "resource_id": "304",
        "vulnerabilities": [
          {
            "updatedtime": "1704365176820",
            "severity": "Moderate",
            "vulnerabilityid": "148376",
            "vulnerabilityname": "Vulnerabilities CVE-2022- 23181,CVE-2020-9484 are fixed in 20 January 2022 Fixed in Apache Tomcat 8.5.75",
            "vulnerability_status": "open"
          },
          {
            "updatedtime": "1704365176820",
            "severity": "Important",
            "vulnerabilityid": "154557",
            "vulnerabilityname": "Vulnerabilities CVE-2022- 25762 are fixed in 28 February 2022 Fixed in Apache Tomcat 8.5.76",
            "vulnerability_status": "open"
          }
        ]
      }
    ]
  },
  "status": "success"
}
```

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