---
title: "Get users by query."
method: GET
path: "/api/user-management"
tags: ["UserManagement"]
---

# Get users by query.

`GET /api/user-management`

## Query parameters

- `query` string, nullable
- `skip` integer
- `take` integer

## Response `200`

Users returned.

- UsersDto
  - `_links` object, required — The links.
  - `total` integer, required — The total number of users.
  - `items` UserDto[], required — The users.
    - `_links` object, required — The links.
    - `id` string, required — The ID of the user.
    - `email` string, required — The email of the user. Unique value.
    - `displayName` string, required — The display name (usually first name and last name) of the user.
    - `isLocked` boolean, required — Determines if the user is locked.
    - `permissions` string[], required — Additional permissions for the user.

## Other responses

- `500` — Operation failed.

---

[API](https://skmtc.net/squidex/apis/squidex-api.md) · [All operations](https://skmtc.net/squidex/apis/squidex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/squidex/squidex-api/revisions/b4a9b62f113a/schema)
