---
title: "List All Devices"
url: "https://public-api-docs.cipherscale.com/apis/cipherscale-api-1/versions/fef69080-6094-4620-8bf0-16fd2de7b598/operations/DevicesController_findByCriteria"
---

> Full API specification: https://public-api-docs.cipherscale.com/apis/cipherscale-api-1/versions/fef69080-6094-4620-8bf0-16fd2de7b598.md

# List All Devices

`GET` `/tenants/devices`

Operation ID: `DevicesController_findByCriteria`

Retrieves a paginated list of all devices registered to the tenant with support for filtering, sorting, and search. This endpoint provides comprehensive device information including connection status, user associations, and hardware details.

## Query parameters

- `sort` (array, optional)
- `limit` (number, optional)
- `offset` (number, optional)

## Responses

- `200` - Successfully retrieved devices
- `401` - Unauthorized - Invalid or missing authentication token
- `403` - Forbidden - Insufficient permissions. Requires OWNER, ADMIN, AUDITOR, or SUPPORT role.

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Cipherscale API
  version: "1.0"
servers:
  - url: https://public-api.cipherscale.com/qa
    description: Cipherscale Public API Server
paths:
  /tenants/devices:
    get:
      operationId: DevicesController_findByCriteria
      summary: List All Devices
      description: Retrieves a paginated list of all devices registered to the tenant
        with support for filtering, sorting, and search. This endpoint provides
        comprehensive device information including connection status, user
        associations, and hardware details.
      parameters:
        - name: sort
          required: false
          in: query
          schema:
            type: array
            items:
              type: string
        - required: false
          name: limit
          in: query
          schema:
            type: number
        - required: false
          name: offset
          in: query
          schema:
            type: number
      responses:
        "200":
          description: Successfully retrieved devices
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PaginatedDto"
        "401":
          description: Unauthorized - Invalid or missing authentication token
        "403":
          description: Forbidden - Insufficient permissions. Requires OWNER, ADMIN,
            AUDITOR, or SUPPORT role.
      tags:
        - Devices
      security:
        - ApiKeyAuth: []
security:
  - ApiKeyAuth: []
components:
  schemas:
    PaginatedDto:
      type: object
      properties: {}
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
```