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

# List Users on Aria Compute ROUTER

> GET /v1/router/users returns a paginated list of user accounts. This admin-only endpoint is used for user management in Aria Compute ROUTER.

Retrieve a list of all user accounts registered on Aria Compute ROUTER. This endpoint is restricted to admin users and returns a collection of user objects containing identity and status fields.

## Endpoint

```http theme={null}
GET /v1/router/users
```

## Authentication

Admin role required. Send the session cookie obtained from login, or include `Authorization: Bearer <api-key>`.

## Response

<ResponseField name="items" type="array">
  Array of user objects.
</ResponseField>

<ResponseField name="items[].id" type="string">
  Unique identifier of the user.
</ResponseField>

<ResponseField name="items[].username" type="string">
  Username of the account.
</ResponseField>

<ResponseField name="items[].email" type="string | null">
  Email address if set, otherwise null.
</ResponseField>

<ResponseField name="items[].role" type="string">
  User role, such as `"user"` or `"admin"`.
</ResponseField>

<ResponseField name="items[].disabled" type="boolean">
  Whether the account is currently disabled.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://router.example.com:8080/v1/router/users \
    -H "Authorization: Bearer <admin-api-key>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "user-abc123",
        "username": "alice",
        "email": "alice@example.com",
        "role": "user",
        "disabled": false
      },
      {
        "id": "user-def456",
        "username": "bob",
        "email": null,
        "role": "admin",
        "disabled": false
      }
    ]
  }
  ```
</ResponseExample>


## Related topics

- [Update Aria Compute ROUTER Users (Admin)](/api-reference/router/users/update.md)
- [Get Current Aria Compute ROUTER User](/api-reference/router/auth/me.md)
- [Log In to Aria Compute ROUTER Session](/api-reference/router/auth/login.md)
- [Register Account on Aria Compute ROUTER](/api-reference/router/auth/register.md)
- [Authenticate with Aria Compute ROUTER](/api-reference/router/authentication.md)