# List users (admin only)

Endpoint: GET /users
Version: 1.0.0
Security: BearerAuth

## Query parameters:

  - `limit` (integer)

  - `offset` (integer)

## Response 200 fields (application/json):

  - `total` (integer, required)

  - `limit` (integer)

  - `offset` (integer)

  - `totalPages` (integer)

  - `currentPage` (integer)

  - `hasMore` (boolean)

  - `users` (array, required)

  - `users.id` (string, required)

  - `users.name` (string, required)

  - `users.email` (string, required)

  - `users.avatar` (string,null)

  - `users.role` (string, required)
    Enum: "MEMBER", "OFFICER", "ADMIN"

  - `users.createdAt` (string, required)

  - `users.updatedAt` (string)

  - `users.isEmailVerified` (boolean)

## Response 401 fields (application/json):

  - `code` (string, required)
    Example: "BAD_REQUEST"

  - `message` (string, required)
    Example: "Invalid request"

  - `error` (any)
    Optional debug payload

## Response 403 fields (application/json):

  - `code` (string, required)
    Example: "BAD_REQUEST"

  - `message` (string, required)
    Example: "Invalid request"

  - `error` (any)
    Optional debug payload

## Response 500 fields (application/json):

  - `code` (string, required)
    Example: "BAD_REQUEST"

  - `message` (string, required)
    Example: "Invalid request"

  - `error` (any)
    Optional debug payload