---
title: "List all devices - v1"
method: GET
path: "/endpoints/v1/devices"
tags: ["Endpoints"]
---

# List all devices - v1

`GET /endpoints/v1/devices`

## Request

- Base URL: `https://apis.druva.com/insync`
- URL: `https://apis.druva.com/insync/endpoints/v1/devices`
- Auth: API key in header `Authorization`

Returns information about all the user devices protected using Druva inSync.

## Query parameters

- `userID` integer
- `userIDs` integer[]
- `deviceIDs` integer[]
- `profileIDs` integer[]
- `searchPrefixDeviceName` string
- `clientVersion` string
- `platformOS` 'win32' | 'linux2' | 'darwin' | 'android' | 'ios'
- `deviceStatus` 'enabled' | 'disabled'
- `upgradeState` 'NOT UPGRADABLE' | 'UPGRADABLE' | 'UPTODATE' | 'SCHEDULED' | 'UNKNOWN'
- `pageToken` string
- `minLastConnected` string, date-time
- `maxLastConnected` string, date-time
- `minAddedOn` string, date-time
- `maxAddedOn` string, date-time
- `serialNumber` string
- `uuid` string
- `deviceMarkedInactive` boolean

## Response `200`

OK

- DeviceList
  - `totalSize` integer: The total number of devices listed in the result pages.
  - `nextPageToken` string: The token to access next page of results. This parameter will be empty for the last page of results.
  - `devices` Device[]
    - `deviceID` integer: The unique id of the device in inSync. Example - 12345
    - `deviceName` string: The device name in inSync. Example - Ernie Carter's Macbook
    - `serialNumber` string: A unique, identifying number assigned to an individual piece of hardware by the manufacturer. Example - PX045
    - `deviceOS` string: The operating system of the device. Example - Mojave
    - `deviceOSVersion` string: The version of the operating system of the device. Example - 10.14 r34567
    - `platformOS` 'win32' | 'linux2' | 'darwin' | 'android' | 'ios': The operating system platform of the device. Example - darwin
    - `uuid` string: A 128-bit number used to uniquely identify device in internet. Example - TY5h67-5674r-675645
    - `clientVersion` string: The inSync Client version installed on the device. Example - 6.1.0 r56746
    - `deviceStatus` 'enabled' | 'disabled': The status of the device. Example - enabled
    - `upgradeState` 'NOT UPGRADABLE' | 'UPGRADABLE' | 'UPTODATE' | 'SCHEDULED' | 'UNKNOWN': The upgrade state of the device.
    - `userID` integer: A unique id of the user in inSync.
    - `totalBackupData` string: The storage quota consumed by the user.
    - `totalBackupDataInBytes` integer: The storage quota consumed by the user (in bytes).
    - `addedOn` string, date-time: The date and time on which the device was added to inSync. Example - 2019-10-25T00:00:00Z
    - `lastUpgradedOn` string, date-time: The date on which the inSync Client was last updated for the user. Example - 2019-10-25T00:00:00Z
    - `lastConnected` string, date-time: The date and time on which the inSync Client last connected with inSync Cloud. Example - 2019-10-25T00:00:00Z
    - `deviceMarkedInactive` boolean: Devices marked as inactive. Example - true

## Other responses

- `400`: Bad Request
- `401`: The request did not include an authentication token or an expired authentication token was supplied.
- `403`: Access denied: Insufficient permissions. User requires specific access rights and minimum permissions. Details: https://help.druva.com/en/articles/15069296
- `404`: The requested resource was not found.
- `500`: The request was not processed due to an internal error in inSync Cloud.
- `501`: Requested HTTP method is not implemented.

---

[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)