# Retrieves a list of all Blocked Devices within the Network.

This API provides detailed information about all devices that have been blocked across the network. It supports filters for OS platform, device type, domain, computer/group, and specific time periods.

## Endpoint

`GET /api/1.4/reports/dcm/blockdeviceaudit`

## Request

### Request URL

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

### Scope

`DesktopCentralCloud.DeviceControl.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Query Parameters

- **page** — integer _(Optional)_
  - Current page number for pagination
- **pagelimit** — integer _(Optional)_
  - Number of records per page
- **isblocked** — integer _(Optional)_
  - 0 - Allowed
  - 1 - Blocked
- **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 - Image
  - 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 Adapters
- **dipId** — string _(Optional)_
  - Filter records based on device instance path
- **period** — integer _(Optional)_
  - Filter by time range
  - 0 - This week
  - 1 - This month
  - 2 - This year
  - 3 - Last week
  - 4 - Last month
  - 5 - Last 2 months
  - 6 - Last 3 months
  - 7 - Last 6 months
  - 8 - Last 9 months
  - 9 - Last year
- **domain** — string _(Optional)_
  - Filter the records based on domain names
- **computer** — long _(Optional)_
  - Filter devices connected to a particular computer. Resource IDs can be obtained from `/api/1.0/som/computers`
- **user** — long _(Optional)_
  - Filter by user resource ID
- **gid** — long _(Optional)_
  - Filter devices connected to a particular group of computers. Group IDs can be obtained from `/api/1.4/customgroup/getCGList`

## Sample Request

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

## Response

### HTTP Code 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

### Possible Response Codes

- **200** — HTTP code

### Sample Response: HTTP 200

Blocked devices report response

```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": "04015160df32988ed07728df07b1a1c737c3aff5aab42687e3a3fafcf59e155b5871111000000000000000026af6cefff9d8118ab5581077e2d235c",
        "domain_netbios_name": "WORKGROUP",
        "userresource.name": "John",
        "product_name": "Unknown",
        "deviceauditevents.target_device_name": "USB  SanDisk 3.2Gen1 USB Device",
        "is_blocked": 1,
        "product_hex_id": "55ab",
        "device_inserted_time": 1756102055000,
        "resource_name": "John",
        "customer_id": 1,
        "class_guid": "{4d36e967-e325-11ce-bfc1-08002be10318}",
        "usage_duration": 0,
        "computer_resource_id": 111301,
        "db_updated_time": 1756102068943,
        "deviceauditevents.target_manufacturer_name": "(Standard disk drives)"
      }
    ]
  },
  "message_version": "1.4",
  "status": "success"
}
```