---
title: "List the status of all devices"
method: GET
path: "/devices/status"
tags: ["Device Catalog"]
---

# List the status of all devices

`GET /devices/status`

## Request

- Base URL: `https://api.us-west-1.saucelabs.com/rdc/v2`
- URL: `https://api.us-west-1.saucelabs.com/rdc/v2/devices/status`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/saucelabs/apis/real-device-access-api-reference/docs/devices/status/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the current status of all devices. For private devices, additional details are available, including the precise state and current user. The delay of this state is < 1s.

## Query parameters

- `state` 'AVAILABLE' | 'IN_USE' | 'CLEANING' | 'REBOOTING' | 'MAINTENANCE' | 'OFFLINE': Current device state. Private devices show specific states; public devices show aggregated states. If any device sharing a descriptorId is available, the descriptor is marked as available.
- `privateOnly` boolean
- `deviceName` string

## Response `200`

Ok

- object
  - `devices` Device[]
    - `descriptor` string, required
    - `isPrivateDevice` boolean, required
    - `state` 'AVAILABLE' | 'IN_USE' | 'CLEANING' | 'REBOOTING' | 'MAINTENANCE' | 'OFFLINE', required: Current device state. Private devices show specific states; public devices show aggregated states. If any device sharing a descriptorId is available, the descriptor is marked as available.
    - `inUseBy` object[]
      - `username` string, required

## Other responses

- `401`: Not Authorized

---

[API](https://skmtc.dev/saucelabs/apis/real-device-access-api-reference.md) - [All operations](https://skmtc.dev/saucelabs/apis/real-device-access-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/saucelabs/apis/real-device-access-api-reference/revisions/f845a4b66e37?raw)