# Retrieves the list of Unique Devices Detected in the Network.

This API lists all unique devices discovered within your network. It supports filters for OS platform, device type, and block status.

## Endpoint

`GET /api/1.4/reports/dcm/devicesummary`

## Request

### Request URL

`https://{serverurl}/api/1.4/reports/dcm/devicesummary`

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

### Scope

`DesktopCentralCloud.DeviceControl.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Query Parameters

- **page** (`integer`, optional): Current page number for pagination.
- **pagelimit** (`integer`, optional): Number of records per page.
- **isblocked** (`integer`, optional):
  - `0` - Allowed (device is permitted)
  - `1` - Blocked (device access is restricted)
- **os_platform** (`string`, optional):
  - `1` - Windows
  - `2` - Mac
- **devicetype** (`long`, optional):
  - `2` - Biometric
  - `3` - Bluetooth
  - `4` - CD-ROM
  - `5` - Disk Drive
  - `9` - Floppy Disk
  - `19` - Imaging Device
  - `20` - Infrared
  - `21` - Keyboard
  - `24` - Modem
  - `26` - Mouse
  - `37` - Printer
  - `42` - Smart Card Reader
  - `46` - Tape Drive
  - `49` - WPD
  - `100` - WPD Apple Devices
  - `102` - Serial Ports (COM)
  - `103` - Parallel Ports (LPT)
  - `104` - Wireless Network Adapters

### Sample Request

```curl
curl --request GET \
  --url https://appdomains/api/1.4/reports/dcm/devicesummary \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### HTTP 200

Response body: `application/json`

- `JSON Object`
  - **message_type** (`string`): Module code identifier.
  - **message_response** (`JSON Object`): Response data container.
  - **message_version** (`string`): API version.
  - **status** (`string`): Status of API call (success/failure).
  - **response_code** (`integer`): HTTP response code.

### Sample Response

Device summary report response with pagination.

```json
{
  "response_code": 200,
  "message_type": "dcm",
  "message_response": {
    "total": 1,
    "limit": 25,
    "page": 1,
    "dcm": [
      {
        "custom_device_name": "--",
        "deviceaudit_id": 17708,
        "device_removed_time": 1756102055000,
        "managedcomputer.friendly_name": "John",
        "vendor_hex_id": "0781",
        "os_platform": 1,
        "vendor_name": "SanDisk Corp.",
        "device_type": "smp.dcm.removablestoragedevice",
        "serial_number": "04015160df32980ed07728df07b1a1c737c3aff5aab42687e3a3fafcf59e155b587111100000000000000026af6cefff9d8118ab5581077e2d235c5c",
        "connected_count": 9,
        "userresource.name": "John",
        "product_name": "Unknown",
        "deviceauditevents.target_device_name": "USB  SanDisk 3.2Gen1 USB Device",
        "is_blocked": 1,
        "product_hex_id": "55ab",
        "last_occurrence": 1756102055000,
        "device_inserted_time": 1756102055000,
        "resource_name": "John",
        "usage_duration": 0,
        "computer_resource_id": 111301,
        "db_updated_time": 1756102068943,
        "deviceauditevents.target_manufacturer_name": "(Standard disk drives)"
      }
    ]
  },
  "message_version": "1.4",
  "status": "success"
}
```