# Retrieves all Device Activities Detected in the Network.

This API provides a detailed list of all device activity events that occurred across the network. Filters are available for OS platform, device type, domain, computer/group, and specific time ranges.

## Endpoints

`GET /api/1.4/reports/dcm/deviceaudit`

## Request URL

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

`{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`

## 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 of all computers 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/deviceaudit \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

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

Device audit 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": "04015160df329808ed07728df07b1a1c737c3aff5aab42687e3a3fafcf59e155b5871111000000000000000026af6cefff9d8118ab5581077e2d235c",
        "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"
}
```