# Retrieves a list of all system misconfigurations detected in the network

This API lists system misconfigurations across the network, with filters for name, description, severity, post-deployment issues, and ID to enable precise data retrieval.

## Endpoints

`GET /dcapi/threats/systemmisconfigurations`

## Request

### Request URL

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

### 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 misconfigurations details per page.

- **severity** `string` (Optional)

  Filters misconfigurations based on the severity provided.

- **os_platform** `string` (Optional)

  Filters misconfigurations based on the platform provided.

- **fix_availability** `string` (Optional)

  Filters misconfigurations based on the fix availability provided.

- **description** `string` (Optional)

  Filters misconfigurations that contain the provided misconfiguration description.

- **affected_systems** `string` (Optional)

- **misconfig_name** `string` (Optional)

  Filters misconfigurations that contain the provided misconfiguration name.

- **solution** `string` (Optional)

  Filters misconfigurations based on the solution provided.

- **reboot_required** `string` (Optional)

  Filters misconfigurations based on the reboot option provided.

- **post_deployment_issues** `string` (Optional)

  Filters misconfigurations that contain the provided post deployment issues.

- **undo_supported** `boolean` (Optional)

  Filters misconfigurations based on the reversibility support provided.

- **category** `string` (Optional)

  Filters misconfigurations based on the category provided.

- **misconfigid** `string` (Optional)

  Filters misconfigurations based on the misconfiguration ID provided.

- **potential_impact** `boolean` (Optional)

  Filters misconfigurations based on the potential impact provided.

### Sample Request

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

## Response

### 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": "2",
    "totalPages": 1,
    "links": {
      "next": null,
      "prev": null
    },
    "page": 1
  },
  "response_code": 200,
  "message_type": "systemmisconfigurations",
  "message_response": {
    "systemmisconfigurations": [
      {
        "severity": "Critical",
        "os_platform": "Windows",
        "fix_availability": "not available",
        "description": "A host-based firewall lets a user define a set of rules that controls incoming and outgoing network traffic across a particular device. This prevents unauthorized access and unrestricted connections to the device. Windows-based computers comes with an in-built firewall. Resolve this misconfiguration to enable Microsoft windows firewall in your windows-based computers.",
        "affected_systems": 1,
        "misconfig_name": "Windows firewall disabled/ No third-party firewall present",
        "solution": "no fix available",
        "reboot_required": "not required",
        "post_deployment_issues": "No Impact",
        "undo_supported": false,
        "category": "Windows Firewall",
        "misconfigid": "4",
        "potential_impact": false
      },
      {
        "severity": "Critical",
        "os_platform": "Windows",
        "fix_availability": "not available",
        "description": "BitLocker is a full disk encryption feature included in Microsoft Windows versions starting with Windows Vista. It is designed to protect data by providing encryption for entire volumes. In many cases, encryption of customer data is required by law. Resolution: It is advisable to enable bitlocker encryption to protect entire disk volumes.",
        "affected_systems": 1,
        "misconfig_name": "Bitlocker not enabled",
        "solution": "no fix available",
        "reboot_required": "not required",
        "post_deployment_issues": "No Impact",
        "undo_supported": false,
        "category": "BitLocker Encryption",
        "misconfigid": "6",
        "potential_impact": false
      }
    ]
  },
  "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.