list_users
List all users in LogicMonitor to audit access, check roles, find user IDs, identify inactive users, and support compliance reporting.
Instructions
List all users in LogicMonitor (LM) monitoring.
Returns: Array of users with: id, username, email, roles, status (active/suspended), last login time, created date, API token count.
When to use:
Audit user access
Find user IDs for API token management
Check who has admin access
Identify inactive users
Compliance reporting
Common filter patterns:
Active users: filter:"status:active"
By email: filter:"email~*@company.com"
By role: filter:"roles:*administrator*"
Recent logins: filter:"lastLoginOn>{epoch}"
Never logged in: filter:"lastLoginOn:0"
Important: A negative "total" value in the response indicates incomplete results. Use pagination (size/offset parameters) or set autoPaginate: true to retrieve all items.
Related tools: "get_user" (details), "list_roles" (available roles), "list_api_tokens" (user's API tokens).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Number of results per page (default: 50, max: 1000). | |
| offset | No | Starting offset for pagination (default: 0). Use this to skip a specific number of results. | |
| autoPaginate | No | Automatically fetch all pages (default: false). When true, fetches all results across multiple pages. When false, returns only the requested page. Use false for large result sets to avoid long response times. | |
| filter | No | Filter expression using LogicMonitor query syntax. Examples: name:*prod*, displayName~*server*, id>100, hostStatus:normal. Available operators: : (equals), ~ (includes), !: (not equals), !~ (not includes), >: (greater than or equals), <: (less than or equals), > (greater than), < (less than). Multiple conditions: Use comma (,) for AND, use || for OR. Do NOT use &&. | |
| fields | No | Comma-separated list of fields to include in response. Examples: "id,displayName,hostStatus" or use "*" for all fields. Omit this parameter to receive a curated set of commonly used fields. |