---
title: "Get All Devices"
method: GET
path: "/devices"
tags: ["devices"]
---

# Get All Devices

`GET /devices`

Retrieve a list of quantum devices available to the authenticated user.

**Query Parameters:**
- **qrn** (string, optional): Filter by device QRN
- **vendor** (string, optional): Filter by vendor
- **providerId** (string, optional): Filter by provider ID
- **deviceType** (string, optional): Filter by device type (`QPU` or `SIMULATOR`)
- **status** (string, optional): Filter by operational status
- **retired** (boolean, optional): Include or exclude retired devices
- **private** (boolean, optional): Filter by visibility (`true` = private, `false` = public)
- **verified** (boolean, optional): Filter by verification status
- **directAccess** (boolean, optional): Filter by direct access availability
- **search** (string, optional): Search by name, description, or about (1–255 characters)
- **sortBy** (string, optional): Field to sort by
- **sortOrder** (string, optional): Sort direction (`asc` or `desc`)
- **page** (integer, optional): Page number (default: 1)
- **limit** (integer, optional): Items per page, max 100 (default: 20)

**Returns:**
- Array of RuntimeDevice objects containing device specifications and pricing information

**Raises:**
- **401**: Authentication required
- **422**: Validation error if query parameters are invalid

## Query parameters

- `qrn` string — Device QRN (qBraid Resource Name)
- `vendor` 'aws' | 'azure' | 'ibm' | 'ionq' | 'qbraid' — Filter devices by vendor
- `providerId` string — Provider ID to filter by
- `deviceType` 'QPU' | 'SIMULATOR' — Filter by hardware type
- `status` 'ONLINE' | 'OFFLINE' | 'RETIRED' | 'UNAVAILABLE' — Filter by operational status
- `retired` boolean — Include or exclude retired devices
- `private` boolean — Filter by device visibility
- `verified` boolean — Filter by device verification status
- `directAccess` boolean — Filter by direct access availability
- `search` string — Search keyword
- `sortBy` 'name' | 'vendor' | 'deviceType' | 'status' | 'numberQubits' | 'createdAt' | 'updatedAt' — Field to sort by
- `sortOrder` 'asc' | 'desc' — Sort order direction
- `page` integer — Page number (1-indexed)
- `limit` integer — Number of items per page

## Response `200`

Successful Response

- ListDevicesResponse — Response schema for listing devices
  - `success` boolean, required
  - `data` RuntimeDevice[], required — Array of devices matching the query filters
    - `name` string, required
    - `qrn` string, required
    - `vendor` 'aws' | 'azure' | 'ibm' | 'ionq' | 'qbraid', required
    - `deviceType` 'SIMULATOR' | 'QPU', required
    - `runInputTypes` string[], required
    - `status` 'ONLINE' | 'UNAVAILABLE' | 'OFFLINE' | 'RETIRED', required — Enumeration for representing various operational statuses of devices. Attributes: ONLINE (str): Device is online and accepting jobs. UNAVAILABLE (str): Device is online but not accepting jobs. OFFLINE (str): Device is offline. RETIRED (str): Device has been retired and is no longer operational.
    - `statusMsg` string, nullable
    - `nextAvailable` string, date-time, nullable
    - `queueDepth` integer, nullable
    - `avgQueueTime` integer, nullable
    - `numberQubits` integer, nullable
    - `paradigm` 'gate_model' | 'analog' | 'annealing' | 'other', required — Enumeration for quantum experiment types. Attributes: GATE_MODEL (str): Gate-based quantum computing (e.g., OpenQASM). ANALOG (str): Analog quantum computing ANNEALING (str): Quantum annealing for optimization problems. OTHER (str): Placeholder for other or unspecified quantum computing models.
    - `modality` string, nullable
    - `noiseModels` string[], nullable
    - `pricingModel` 'fixed' | 'dynamic', nullable
    - `pricing` DevicePricing — Represents pricing information for a quantum device.
      - `perTask` number, required — A monetary amount where 1 Credit = $0.01 USD.
      - `perShot` number, required — A monetary amount where 1 Credit = $0.01 USD.
      - `perMinute` number, required — A monetary amount where 1 Credit = $0.01 USD.
    - `directAccess` boolean

## Other responses

- `401` — Unauthorized
- `422` — Validation Error

---

[API](https://skmtc.dev/qbraid/apis/qbraid-runtime-api.md) · [All operations](https://skmtc.dev/qbraid/apis/qbraid-runtime-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qbraid/qbraid-runtime-api/revisions/6e818ad19cde/schema)