---
title: "List users"
method: GET
path: "/v2/users"
tags: ["system"]
---

# List users

`GET /v2/users`

Returns list of users

## Query parameters

- `userType` 'TECHNICIAN' | 'END_USER'
- `includeRoles` boolean

## Response `default`

default response

- object[]
  - `id` integer — User identifier
  - `uid` string, uuid — User universally unique identifier
  - `firstName` string
  - `lastName` string
  - `email` string
  - `phone` string
  - `enabled` boolean
  - `administrator` boolean
  - `permitAllClients` boolean
  - `notifyAllClients` boolean
  - `mustChangePw` boolean
  - `mfaConfigured` boolean
  - `userType` 'TECHNICIAN' | 'END_USER'
  - `invitationStatus` 'REGISTERED' | 'PENDING' | 'EXPIRED'
  - `organizationId` integer — Identifier of organization for end-users
  - `deviceIds` integer[] — Device IDs which end-user is authorized to access
  - `assignedDeviceIds` integer[] — Device IDs which user is assigned
  - `roles` string[] — A list of role names assigned to the user. This is provided when the 'includeRoles' query parameter is set to 'true'

---

[API](https://skmtc.net/ninjarmm/apis/ninjaone-public-api-2-0.md) · [All operations](https://skmtc.net/ninjarmm/apis/ninjaone-public-api-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ninjarmm/ninjaone-public-api-2-0/revisions/753f26d46650/schema)