# Retrieves File Shadow Operation Details across the Network.

This API lists all file shadow operations performed on network-connected devices. It supports filters based on status, time period, domain, computer, group, and recent activity.

## Endpoint

`GET /api/1.4/reports/dcm/fileshadow`

## Request URL

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

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

- **gid** `long` *(Optional)*  
  Filter devices connected to a group of computers based on its group ID. Group IDs can be obtained from `/api/1.4/customgroup/getCGList`

- **numberOfDays** `long` *(Optional)*  
  Filter file activities that occurred in the last N days

- **period** `integer` *(Optional)*  
  Filter based on time period:
  - `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

- **start** `long` *(Optional)*  
  Start timestamp for date range filter

- **end** `long` *(Optional)*  
  End timestamp for date range filter

- **status** `long` *(Optional)*  
  Filter records based on file shadow status:
  - `1` - Yet to start
  - `2` - Excluded
  - `3` - Wait
  - `4` - Ready
  - `5` - In progress
  - `6` - Success
  - `7` - Failed
  - `8` - Cancelled

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

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/api/1.4/reports/dcm/fileshadow \
  --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

## Sample Response: HTTP 200

File shadow report response

```json
{
  "response_code": 200,
  "message_type": "dcm",
  "message_response": {
    "total": 1,
    "limit": 25,
    "page": 1,
    "dcm": [
      {
        "custom_device_name": "--",
        "extension": "xml",
        "last_modified_time": 1756101935079,
        "computerresource.domain_netbios_name": "WORKGROUP",
        "file_name": "metadata.xml",
        "managedcomputer.friendly_name": "John",
        "vendor_hex_id": "0781",
        "serial_number": "04015160df329088ed07728df07b1a1c737c3aff5aab42687e3a3fafcf59e155b5871111000000000000000026af6cefff9d8118ab5581077e2d235c",
        "remote_shadow_path": "\\\\SYSTEM-1\\SYS\\2025-08-25\\WORKGROUP\\John\\John\\2025-08-25--06-05-06-257 -  USB  SanDisk 3.2Gen1 USB Device\\New folder\\metadata.xml",
        "userresource.name": "John",
        "connected_time": 1756101906257,
        "device_name": " USB  SanDisk 3.2Gen1 USB Device",
        "source_file_path": "E:\\New folder\\metadata.xml",
        "product_hex_id": "55ab",
        "finalstatus.overall_status": "dc.common.SUCCESS",
        "file_shadow_remarks": "smp.agent.fs.SUCCESS",
        "file_length": 2345,
        "computerresource.name": "John"
      }
    ]
  },
  "message_version": "1.4",
  "status": "success"
}
```