---
title: "GET /_system/users/search - Users · RUAL Documentation"
description: "Search system users (GET) with Elasticsearch query parameters"
canonical: https://docs.rual.nl/cluster/api/users/system-users-search-get
language: en
---

# GET /_system/users/search

Search system users (GET) with Elasticsearch query parameters

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **limit** optional | `integer` | `1` |  |
| **offset** optional | `integer` | `1` | Elasticsearch query offset parameter |

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **[authorization](https://docs.rual.nl/cluster/api#token-providing)** required | `string` | `"Bearer access_token"` | Access token |

```
{}
```

```
{
  "code": 401,
  "error": "INVALID_ACCESS_TOKEN"
}
```

| Status | Error Code | Description |
| --- | --- | --- |
| `401` | `INVALID_ACCESS_TOKEN` | Authentication required or invalid token |
| `403` | `INSUFFICIENT_PERMISSIONS` | Insufficient permissions for this operation |

| Permission | Description |
| --- | --- |
| `Bearer token` | Access token required via Authorization header, x-authtoken, x-token, query param, or cookie |
| `users_view` | Required scope: users_view |