# 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

| Parameter | Type | Required | Description |
|---|---|---|---|
| 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:<br>0 - This week<br>1 - This month<br>2 - This year<br>3 - Last week<br>4 - Last month<br>5 - Last 2 months<br>6 - Last 3 months<br>7 - Last 6 months<br>8 - Last 9 months<br>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:<br>1 - Yet to start<br>2 - Excluded<br>3 - Wait<br>4 - Ready<br>5 - In progress<br>6 - Success<br>7 - Failed<br>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`

| Parameter | Type | Description |
|---|---|---|
| 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

| Code | Type |
|---|---|
| 200 | HTTP 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"
}
```