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

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

# List All Users

`GET` `/tenants/users`

Operation ID: `UsersController_findAll`

Retrieves a paginated list of all users within the tenant, with support for sorting, filtering, and search functionality. This endpoint is essential for user management dashboards and administrative operations.

## Query parameters

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

## Responses

- `200` - Successfully retrieved users
- `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/users:
    get:
      operationId: UsersController_findAll
      summary: List All Users
      description: Retrieves a paginated list of all users within the tenant, with
        support for sorting, filtering, and search functionality. This endpoint
        is essential for user management dashboards and administrative
        operations.
      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 users
          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:
        - Users
      security:
        - ApiKeyAuth: []
security:
  - ApiKeyAuth: []
components:
  schemas:
    PaginatedDto:
      type: object
      properties: {}
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
```