---
title: "Retrieve protected devices"
method: GET
path: "/v1/devices"
tags: ["devices"]
---

# Retrieve protected devices

`GET /v1/devices`

Retrieve the protected devices in a workspace. This call supports pagination; default page size includes 20 devices.

## Query parameters

- `enrollmentCode` string — Filter by Coro’s unique enrollment code for a device.
- `page` string — API responses use pagination to reduce loading time. Return a specific page of results, using a zero-based page index (0..N).
- `pageSize` string — API responses use pagination to reduce loading time. Return a maximum of this many items per page.

## Headers

- `Workspace` string, required

## Response `200`

Success

- DevicePageResponse
  - `items` DeviceResponse[]
    - `enrollmentCode` string — Coro’s unique enrollment code for the device.
    - `deviceId` string — The 16-byte unique number of the device.
    - `deviceModel` string — The device model.
    - `hostname` string — The host name of the device.
    - `osType` string — The operating system installed on the device.
    - `osVersion` string — The operating system version that is currently installed on the device.
    - `appVersion` string — The version of Coro that is currently installed on the device.
    - `activationTime` integer — UNIX timestamp in milliseconds for the time when the device was originally activated in Coro.
  - `totalElements` integer — The total number of records that exist for the request.

## Other responses

- `400` — Bad request, validation error
- `401` — Unauthorized request
- `403` — Access forbidden
- `429` — Too Many Requests
- `500` — Internal server error

---

[API](https://skmtc.net/coro/apis/coro-cybersecurity-public-api.md) · [All operations](https://skmtc.net/coro/apis/coro-cybersecurity-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coro/coro-cybersecurity-public-api/revisions/b635522b2393/schema)