---
title: "Collect devices (replaced by POST /v1/device/query)"
method: GET
path: "/v1/device"
tags: ["Device"]
deprecated: true
---

# Collect devices (replaced by POST /v1/device/query)

`GET /v1/device`

> **Deprecated.**

Get all (or some of) the devices which are monitored by roles of which the user is a member. Using the query parameters, it is possible to apply filters both on devices which are returned, and on the properties of those devices. The POST /v1/device/query is a preferable alternative, which can better handle complex filters

## Query parameters

- `skipHash` string
- `fields` string[]
- `id` integer[]
- `nodeId` string[]
- `nodeType` string[]
- `viewId` integer[]
- `roleId` integer[]
- `companyId` integer[]
- `isActive` boolean

## Response `200`

An array with the filtered devices. For each device, the readable and editable properties of the device are returned, as well as information regarding the editabilities of those properties and whether the user has monitorManagement rights for the device. If the fields query parameter was specified, only those device properties which were listed are returned.

- object
  - `device` Def8[]
    - `id` integer, required — Id of the device
    - `lastUpdate` string, required — Last update of the device in server time, formatted as an ISO 8601 string
    - `properties` object, required
    - `userRights` object, required — An object specifying which device properties a user may view or edit
      - `propertyEditabilities` object, required
      - `monitorManagement` boolean, required

## Other responses

- `204` — This is returned when skipHash is provided and the provided hash matches the current hash calculated using the lastUpdate properties of the selected devices
- `400` — Invalidly formatted query parameters
- `401` — Authentication required or token invalid

---

[API](https://skmtc.dev/eniris/apis/eniris-metadata-telemetry-query-api.md) · [All operations](https://skmtc.dev/eniris/apis/eniris-metadata-telemetry-query-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eniris/eniris-metadata-telemetry-query-api/revisions/fe3723575e19/schema)