---
title: "List eDiscovery Download Clients - v4"
method: GET
path: "/legalholds/v4/clients"
tags: ["Legal Hold"]
---

# List eDiscovery Download Clients - v4

`GET /legalholds/v4/clients`

## Request

- Base URL: `https://apis.druva.com/insync`
- URL: `https://apis.druva.com/insync/legalholds/v4/clients`
- Auth: API key in header `Authorization`

Returns a list of all the eDiscovery Download Clients that are configured in inSync.

## Query parameters

- `sortBy` 'name' | 'clientVersion' | 'cplatform' | 'createdBy'
- `sortOrder` 'asc' | 'desc'
- `connectionStatus` 'Connected' | 'Disconnected' | 'Not Registered'
- `searchBy` string
- `pageNumber` integer
- `pageSize` integer

## Response `200`

OK

- ListClients
  - `totalPages` integer: Total number of pages for the API Response. Example - 1
  - `totalResults` integer: Total number of results. Example - 1
  - `clients` ClientDetails[]
    - `ddClientHostName` string: The name of the device where the client is installed. Example - John-8765-Windows-PC
    - `clientSecretId` string: API secret part of API credentials. Example - E1AMfwKbQUXGY6sbPB9igPyDL3CbhyWa
    - `client_features` object: A dictionary containing information about the features that the client supports.
      - `metadata_download` true | false
      - `zip_download` true | false
      - `data_download` true | false
      - `integrity_check` true | false
    - `cplatform` string: The operating system of the device where the client is installed. Example - win32
    - `name` string: Name of the eDiscovery Download Client machine. Example - client1_PF_123
    - `clientVersion` string: Version of the eDiscovery Download Client. Example - 1.1.1
    - `ip` string: IP address of the eDiscovery Download Client machine. Example - 110.11.14.10
    - `clientId` integer: Client ID part of API credentials. Example-59
    - `connectionStatus` 'Not Registered' | 'Connected' | 'Disconnected': Connection status of the eDiscovery Download Client. It can be any of the following statuses:
    - `createdBy` string: Name of admin who created the eDiscovery Download Client. Example - John Doe
    - `defaultDownloadLocation` string: Default download location for eDiscovery download. Example - 'D:\Data'
    - `activationTime` integer: Timestamp when the eDiscovery Download Client machine was activated. Example - 1624887294
  - `pageNumber` integer: Page number for which API response is expected. Example - 1
  - `pageSize` integer: Page Size for API response. Example - 100

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Access denied: Insufficient permissions. User requires specific access rights and minimum permissions. Details: https://help.druva.com/en/articles/15069296
- `500`: Internal Server Error

---

[API](https://skmtc.dev/druva/apis/insync-cloud.md) - [All operations](https://skmtc.dev/druva/apis/insync-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/druva/apis/insync-cloud/revisions/a0ce6d05033c?raw)