---
title: "List devices"
method: GET
path: "/api/devices"
---

# List devices

`GET /api/devices`

## Request

- Base URL: `https://reduck.ai`
- URL: `https://reduck.ai/api/devices`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

List the devices registered to your account.

## Response `200`

OK

- Device[]
  - `id` string, required
  - `name` string, nullable, required
  - `browser` string, nullable, required
  - `os` string, nullable, required
  - `file_access` boolean, nullable, required
  - `reachable` boolean, required: Whether a wake can be attempted: the device has a Web Push subscription we have not been told is gone. NOT a statement that the browser is running — a push to a closed Chrome is accepted and queued, so this stays true until the subscription is revoked (extension removed, site data cleared, push-service expiry). A run on a device that is `reachable` but shut fails when its browser never answers CDP.
  - `created_at` string, required
  - `concurrency_budget` number, required
  - `last_seen_at` string, nullable, required: When the device last said anything to Reduck (ISO 8601): the extension's heartbeat, a pong, a registration or a push subscription. The heartbeat runs every few minutes while the device's Chrome profile is open, so an old value means that profile is closed, asleep or offline. NULL = the device has not reported since Reduck started recording it.
  - `extension_version` string, nullable, required: The extension version the device's heartbeat reports. Only an extension with a heartbeat sends one, and that heartbeat is what gives the device a new push address once the old one is refused: NULL means an extension too old to recover from that on its own.
  - `heartbeat_min` number, required: Minutes between two heartbeats of a device that has one: what the app asks every extension for, read by whoever judges how long a silence means the device's profile is closed.

## Other responses

- `401`: Not authenticated
- `403`: Forbidden

---

[API](https://skmtc.dev/reduck/apis/reduck-api.md) · [All operations](https://skmtc.dev/reduck/apis/reduck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reduck/apis/reduck-api/revisions/a573b91206d6?raw)