> ## Documentation Index
> Fetch the complete documentation index at: https://cockroachlabs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List users

> List SQL users on this cluster.



## OpenAPI

````yaml /openapi/cluster-api-v2.json get /users/
openapi: 3.0.0
info:
  description: >-
    REST API for querying information about CockroachDB cluster health, nodes,
    ranges,

    sessions, and other meta information. For additional details, see
    cockroachlabs.com/docs/stable/cluster-api.
  title: CockroachDB v2 API
  license:
    name: Business Source License
  version: '2.0'
  x-logo:
    url: https://www.cockroachlabs.com/docs/images/cockroachlabs-logo-170.png
    backgroundColor: '#FFFFFF'
    altText: Cockroach Labs logo
servers:
  - url: https://localhost/api/v2
  - url: http://localhost/api/v2
security: []
paths:
  /users/:
    get:
      summary: List users
      description: List SQL users on this cluster.
      operationId: listUsers
      parameters:
        - description: Maximum number of results to return in this call.
          name: limit
          in: query
          schema:
            type: integer
        - description: Continuation token for results after a past limited run.
          name: offset
          in: query
          schema:
            type: integer
      responses:
        '200':
          description: Users response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/usersResponse'
      x-codeSamples:
        - lang: Shell + Curl
          source: |-
            curl --request GET \
              --url 'https://localhost/api/v2/users/?limit=SOME_INTEGER_VALUE&offset=SOME_INTEGER_VALUE'
components:
  schemas:
    usersResponse:
      type: object
      title: Response for listUsers.
      properties:
        next:
          description: >-
            The continuation token, for use in the next paginated call in the
            `offset`

            parameter.
          type: integer
          format: int64
          x-go-name: Next
        users:
          description: A list of users for the CockroachDB cluster.
          type: array
          items:
            $ref: '#/components/schemas/UsersResponse_User'
          x-go-name: Users
      x-go-package: github.com/cockroachdb/cockroach/pkg/server
    UsersResponse_User:
      type: object
      title: Username of the user.
      properties:
        username:
          type: string
          x-go-name: Username
      x-go-package: github.com/cockroachdb/cockroach/pkg/server/serverpb

````