---
title: "Get users"
method: GET
path: "/v1/users"
tags: ["Users (User)"]
---

# Get users

`GET /v1/users`

## Query parameters

- `username` string
- `role` string
- `sortBy` string
- `limit` integer
- `page` integer

## Response `200`

Users retrieved successfully

- GetUsersResponse
  - `users` UserResponse[] — List of users.
    - `username` string — Username of the user.
    - `userUuid` string, uuid, nullable — Unique identifier for the user. Can be null.
    - `role` 'client' | 'admin' — Role of the user.

## Changes

- **2026-07-17** `e825144e9ffd` — 1 info
  - added the optional property `users` to the response with the `200` status
- **2023-08-01** `eaa698f0f7cb` — 1 warning
  - removed the optional property `users` from the response with the `200` status

[Change history](https://skmtc.dev/openloyalty/apis/loyalty-blockchain-api/changes/v1/users/get.md)

---

[API](https://skmtc.dev/openloyalty/apis/loyalty-blockchain-api.md) · [All operations](https://skmtc.dev/openloyalty/apis/loyalty-blockchain-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openloyalty/loyalty-blockchain-api/revisions/e825144e9ffd/schema)